home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / ace185b.zip / ACECOMM.DOC < prev    next >
Text File  |  1994-04-06  |  298KB  |  10,685 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.      ▄▄▄▄▄                        ▄▄▄▄▄
  11.   ▐████████▌   ▄▄▄▄▄           ▐████████▌
  12.  ▐████ ▐████▐████████▌ ▄▄▄▄▄▄▄▐████  ████ ▄▄▄▄▄
  13.  ▐███▌ ▐███▐████  ████▐███████▐███▌      ███████▌
  14. ▐██████████▐███▌      ████    ▐████     ███   ███   ▄▄▄▄▄▄      ▄▄▄▄▄
  15. ▐███▌ ▐███▐█████     ███████▐█████     ███     ███▐█████████ ▐█████████
  16. ████ ▐████▐███▌  ███▐███     ▐███▌  ███▐██▌   ███▐███ ███ ▐█▌███ ███ ▐█▌
  17. ███▌ ▐███▌ █████████▐██████▌  ████████  ████████ ▐██ ▐██ ███▐██▌▐██ ▐██
  18.  ▀▀   ▀▀▀   ▀▀▀▀▀    ▀▀▀▀▀▀    ▀▀▀▀▀      ▀▀▀▀   ▀▀      ▀▀  ▀▀      ▀▀▀
  19.  
  20.  
  21.  
  22. AceComm (tm)
  23.  
  24. User's Guide
  25.  
  26.  
  27.  
  28. Copyright 1991-1994 by MGP Software, all rights reserved.
  29.  
  30. All rights reserved.  No part of this publication may be reproduced, stored in
  31. a retrieval system, or transmitted by any means, electronic, mechanical,
  32. photocopying, recording, or otherwise, without express written permission from
  33. MGP Software.  The software described in this publication is furnished under a
  34. license agreement and may be used or copied only in accordance with the terms
  35. of that agreement.
  36.  
  37. This publication and its associated software are sold without warranties,
  38. either expressed or implied, regarding their merchantability or fitness for any
  39. particular application or purpose.  The information in this publication is
  40. subject to change without notice and does not represent a commitment on the
  41. part of MGP Software.  In no event shall MGP Software be liable for any loss of
  42. profit or any other commercial damage, including but not limited to special,
  43. incidental, consequential, or other damages resulting from the use of or the
  44. inability to use this product, even if MGP Software has been notified of the
  45. possibility of such damages.
  46.  
  47.  
  48. First Printing, April 1994
  49.  
  50. AceComm version 1.85
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. All brand and product names mentioned in this publication are trademarks or
  63. registered trademarks of their respective holders.
  64.  
  65.  
  66.  
  67.  
  68. AceComm Software Support
  69.  
  70.  
  71.  
  72. You can get more help by contacting the
  73. author Michael Phelps at the following
  74.  
  75. - VOICE 602-846-4563 6 days 12-7pm MST
  76.  
  77. - BBS   602-846-2940 24 hours
  78.  
  79. - COMPUSERVE User ID 75120,3306
  80.  
  81. - FIDONET ADDRESS 1:114/35
  82.  
  83. - FIDONET COMM echo
  84.  
  85. - FIDONET ACECOMM echo
  86. I distribute the "ACECOMM" echo to
  87. USA NODES, until it makes BACKBONE.
  88.  
  89. - Write to: MGP Software (AceComm)                 *New Address*
  90.             BOX 301 C  Route 3                      Yes we are moving
  91.             Detroit Lakes, MN 56501 USA             later this year.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.                 T a b l e   o f   C o n t e n t s
  101.  
  102.  
  103. Chapter 1  Introduction........................................1
  104.               QUICK START......................................2
  105. Chapter 2  Modem Setup.........................................7
  106. Chapter 3  Terminal Area......................................12
  107.               Pop Up Reference................................14
  108. Chapter 4  PRM-data Menus Area................................16
  109.               Terminal Area Options...........................17
  110.               Terminal Screen Options.........................20
  111.               Memory Manager..................................21
  112.               Internal Protocol Options.......................22
  113.               Dialing Area Options............................24
  114.               Serial Port Setup...............................28
  115.               Port Select/Configure...........................28
  116.               UART Line Control...............................30
  117.               Modem Response Strings..........................33
  118.               Modem Commands..................................35
  119.               Modem Control...................................36
  120.               Default Video Emulation.........................36
  121.               Key Translation Sequence file (.KTS)............38
  122.               Keyboard Redefinition...........................39
  123.               Directories in Use Menu.........................43
  124.               External Programs Setup.........................45
  125.               Auto Engage Protocols...........................47
  126.               "Intelligent Auto Log On Technology" (tm).......50
  127.               Mass Menu Attribute Changes.....................52
  128.               IEMSI Data......................................54
  129. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS......................58
  130.               Internal and External Receive Protocols.........59
  131.               Internal and External Sender Protocols..........63
  132. Chapter 6  Telephone Directory Area...........................66
  133. Chapter 7  Auto Answer Setups.................................77
  134. Chapter 8  Event Schedules....................................79
  135. Chapter 9  User Definable Menus...............................81
  136. Chapter 10 Point Mailer Setup.................................85
  137. Chapter 11 File List/Utility Area.............................94
  138. Chapter 12 ACECOMM DATA FILES.................................98
  139.               ACE.PRM / .CTL..................................99
  140.               KTS files......................................100
  141.               KBD files......................................100
  142.               REQ/FLO,LST,SCR,FON files......................101
  143. Chapter 13 Mouse Support.....................................102
  144. Chapter 14 AceComm Macro Language............................103
  145. Chapter 15 Macros list.......................................105
  146.  
  147.  
  148.  
  149.                 T a b l e   o f   C o n t e n t s
  150.  
  151.  
  152.               Local User Input (LUI) Functions...............106
  153.               Character I/O Functions........................110
  154.               Flags..........................................124
  155.               File Functions.................................125
  156.               Data Transfer functions........................128
  157.               Dialing/Fon.Record.............................131
  158.               Misc Functions.................................134
  159. Chapter 16 MACRO Parameter Symbols...........................137
  160.               PRM-data Representatives.......................138
  161.               Replaceable Macro Functions....................144
  162. Chapter 17 Scripts...........................................145
  163.               AutoScriptGen (Tm).............................146
  164.               Labels, Gotos, Data Area.......................151
  165.               Mini Host Script Example.......................154
  166. Chapter 18 Whats New?........................................161
  167. Chapter 19 WARRANTY..........................................164
  168. Chapter 20 LICENSE...........................................166
  169. Chapter 21 AceComm Registration..............................170
  170. Chapter 22 Order Form........................................172
  171.  
  172.  
  173. Chapter 1  Introduction
  174.  
  175. Chapter 1  Introduction
  176.  
  177.  
  178.  
  179. What is AceComm?
  180.  
  181.  
  182. AceComm is a unique blend of expert software design and innovative features.
  183.  
  184. A communications program especially designed for today's high speed modem.
  185. AceComm provides a default setup that is ready to run with most Hayes
  186. compatible modems.  The AceComm package contains a modem install utility, that
  187. will install your Hayes compatible modem into AceComm.
  188.  
  189. AceComm supports a macro driven keyboard which features complete key
  190. redefinition.  The macro language provides a powerful interface to the AceComm
  191. internal functions, as well as many computer services.  The macro language can
  192. be used with AceComm's keyboard, User definable menus, and in the script
  193. language files.
  194.  
  195. AceComm's terminal area provides a key driven and or menu driven interface.
  196. With AceComm's key-redef and macro language, complete control over any complex
  197. task is just a key press away.
  198.  
  199. AceComm supports user definable menus.  Menus that can be made to display and
  200. offer user definable functions.  Menus that are available as pop up menus at
  201. any time from the terminal area.
  202.  
  203. AceComm supports an internal point mail system which uses the EMSI handshake
  204. protocol.
  205.  
  206. A time (event) scheduler supports the point mail system and any other automated
  207. process the user wants to define.  The scheduler is capable of beginning and
  208. ending events as they come around on the clock.  Each schedule contains it's
  209. own macro stack area.  The macro stack is run at the beginning of the
  210. schedule.  This serves to automate and make un-attended a very wide range of
  211. computer tasks.
  212.  
  213. An automatic script generating function can record on line sessions to script
  214. files needing little to no editing.
  215.  
  216. Intelligent Auto Log On Technology (tm) automates log on to most BBS and host
  217. services.
  218.  
  219. IEMSI log on are provided for BBS systems that support IEMSI.
  220.  
  221.  
  222.  
  223.  AceComm Utilities
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233. Chapter 1  Introduction
  234.  
  235. AceComm comes with several utilities for added support.  Utilities for modem
  236. install, backing up the configuration files, creating unique keyboard
  237. emulation, converting BBS lists and many other services that enhance and extend
  238. the overall AceComm services.  Some of these utilities are considered as part
  239. of the default setup, and will be present in the AceComm directory upon
  240. install.  Other utilities will be placed into a sub directory of there own.  We
  241. call these "Extra Utilities".
  242.  
  243.  
  244.  
  245.  AceComm Extra Utilities
  246.  
  247. The Acecomm package comes with several support utilities which add to and
  248. enhance the standard installation.  The utilities are located in a compressed
  249. file named ACEUTIL.  Here you will find a USBBS list to ACE.FON file converter
  250. capable of converting the whole list or 1 area code.  ANSI/AVATAR filter for
  251. removing video control codes from a file outputting to another file.  Custom
  252. keyboard video emulation compiler can create keyboard emulation files from
  253. ascii definition files (examples provided).  AceComm's point mail system is
  254. supported by several utilities that make interface AceComm to a FIDONET
  255. NodeList.  AceComm's NodeList handler is said to be the best and faster of all
  256. programs offering point mail services.
  257.  
  258. ANSIFILT.EXE ANSI/AVATAR video code filter from files
  259.  
  260. CBF.EXE     Convert BBS list to AceComm .FON file
  261.  
  262. UBF.EXE     Convert US BBS list to AceComm .FON file
  263.  
  264. KTS.EXE     Compile custom keyboard emulation files
  265.  
  266. IDX.EXE     Index the FidoNet NODELIST for AceComm's use
  267.  
  268.  
  269.  
  270.  
  271. QUICK START INSTRUCTIONS FOR AceComm & Utilities
  272.  
  273. Last revised 4/1/94
  274.  
  275. Distribution DISK
  276. -----------------
  277. The AceComm package is distributed in a compressed format.  The compression
  278. utility used with AceComm is the current version of LHA (this writing LHA213).
  279. AceComm package and sub-packages are compressed as SelF eXtracting "SFX"
  280. files.  This means the compressed file "ARCHIVE" uses an .EXE file extension.
  281. This SFX format allows you the user to simply type the name of an archive.  The
  282. archive's SFX code will execute, and extract the files to their un-compressed
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.        Page 1              AceComm (tm) v 1.85
  290.  
  291.  
  292. Chapter 1  Introduction
  293.  
  294.            QUICK START
  295.  
  296. form.
  297.  
  298. Electronic Distribution
  299. -----------------------
  300. Many BBS systems will store the distributed SFX file inside an archive envelope
  301. of their default archive.  The AceComm BBS provides the AceComm package in ARJ
  302. and ZIP format.  SFX files as described above are appropriately renamed and
  303. contained inside the main package, as regular compressed files.
  304.  
  305.  
  306.  
  307.  
  308. INSTALL.BAT
  309. -----------
  310. The easiest way to AceComm is to just run INSTALL.BAT.  The batch file will run
  311. ACTL.EXE.  ACTL.EXE assembles ACE.CTL into ACE.PRM.  ACE.CTL is an ascii
  312. control file that can be edited with any text editor or created later with the
  313. DPRM.EXE utility (included).  ACTL creates sub directories defined inside
  314. ACE.CTL.  Directories defined in the default setup are CAP, FON, FILES, KTS,
  315. SCR, and MAIL.  INSTALL.BAT copies FON files into FON, KTS files into KTS, DOC
  316. files into a DOC sub directories.  INSTALL.BAT then runs ACE.EXE All setup data
  317. can be configured from inside AceComm.  Install.bat will get you up and
  318. running, you may need to set the com port to match that of your modem.
  319.  
  320.  
  321.  
  322.  
  323. QUICK SETUP STEPS
  324. -----------------
  325. If you down loaded AceComm
  326.      go to    "Step 1 for Electronic distributed files"
  327.  
  328. Step  1  for Distribution DISK
  329.  
  330.    - Un compress the AceComm package into it's own sub directory.
  331.      This example assumes the filename ACE170.EXE
  332.  
  333.      ACE170 means version 1.70
  334.  
  335.      .EXE means AceComm is distributed as a SelF eXtracting
  336.      archive (SFX)
  337.                 Example
  338.  
  339.         At the DOS prompt type:  md \ace
  340.         At the DOS prompt type:  copy ACE170.EXE \ACE
  341.         At the DOS prompt type:  cd \ace
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.        Page 2              AceComm (tm) v 1.85
  349.  
  350.  
  351. Chapter 1  Introduction
  352.  
  353.            QUICK START (continued)
  354.  
  355.         At the DOS prompt type:  ACE170
  356.  
  357.      The basic setup files will be ready in a sub directory ACE.  Other files
  358.      that include SFX in the filename and end in .EXE file extension, are also
  359.      SelF eXtracting archives.  These files are enhancements to the basic
  360.      setup.
  361.  
  362.  
  363.  
  364. Step 1 for Electronic distributed files
  365.  
  366.      If you down loaded AceComm from a BBS the archive will be in another format
  367.      such as ACE170.ARJ or ACE170.ZIP.  If this is the case you will need to
  368.      use the compression utility that corresponds to the file extension to
  369.      de-compress the AceComm package.
  370.  
  371.                 Example for ACE170.ZIP
  372.  
  373.         At the DOS prompt type:  md \ace
  374.         At the DOS prompt type:  copy ACE170.ZIP \ACE
  375.         At the DOS prompt type:  cd \ace
  376.         At the DOS prompt type:  PKUNZIP ACE170
  377.  
  378.      The basic setup files will be ready in a sub directory ACE.  Other
  379.      archives files that included are enhancements to the basic setup.
  380.  
  381.  
  382.  
  383.  
  384. Step 2
  385.    - Read ACTL.DOC  (1 page)
  386.  
  387.    - Run ACTL.EXE (assemble ACE.CTL into ACE.PRM)
  388.  
  389.                 Example ACTL ace.ctl
  390.  
  391.    ACTL.EXE need only be run when creating a new PRM file is desired.  All
  392.    PRM-data is configurational from within inside AceComm.
  393.  
  394.    Note: AceComm will invoke ACTL.EXE directly when no ACE.PRM file is found in
  395.          the start up directory.
  396.  
  397.  
  398. Step 3
  399.    - Run ACE.EXE
  400.         At the DOS prompt type:  ACE
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.        Page 3              AceComm (tm) v 1.85
  408.  
  409.  
  410. Chapter 1  Introduction
  411.  
  412.            QUICK START (continued)
  413.  
  414.  
  415.  
  416. OPTIONAL Not required for QUICK START
  417. -------------------------------------
  418. A utility DPRM.EXE is provided to clone your PRM file into an ascii control
  419. file.  DPRM will save your custom setup to a file that ACTL.EXE can later
  420. use to build the custom PRM file back.  This is also the means used for
  421. upgrading AceComm versions.
  422.  
  423.  
  424.  
  425. The following are enhancements to the AceComm package
  426.  
  427. a) FON_SFX.EXE (distributed)  FON.ZIP/ARJ (BBS)
  428.    FON_SFX contains several sample .BBS, FON, and .NOD files.
  429.  
  430.    It is suggested that FON_SFX be un-compressed inside a sub directory to the
  431.    AceComm directory
  432.  
  433.                 Example: C:\ACE\FON
  434.  
  435.         At the DOS prompt type:  md \ace\fon
  436.         At the DOS prompt type:  copy FON_SFX.EXE \ace\fon
  437.         At the DOS prompt type:  cd \ace\fon
  438.         At the DOS prompt type:  FON_SFX
  439.         At the DOS prompt type:  cd \ace
  440.  
  441.    NOTE: ACTL creates these directories if defined in ACE.CTL and
  442.          not found.
  443.  
  444. b) KTS_SFX.EXE (Distributed)  KTS.ZIP/ARJ (BBS)
  445.    KTS_SFX contains the KTS files included in the default setup, as well as the
  446.    ascii versions.  Ascii version KTS files share the filename with KTS files,
  447.    but use .ASC extension.
  448.  
  449.    It is suggested that KTS_SFX be un-compressed inside a sub directory to the
  450.    AceComm directory
  451.  
  452.                 Example: C:\ACE\KTS
  453.  
  454.         At the DOS prompt type:  md \ace\kts
  455.         At the DOS prompt type:  copy KTS_SFX.EXE \ace\kts
  456.         At the DOS prompt type:  cd \ace\kts
  457.         At the DOS prompt type:  KTS_SFX
  458.         At the DOS prompt type:  cd \ace
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.        Page 4              AceComm (tm) v 1.85
  467.  
  468.  
  469. Chapter 1  Introduction
  470.  
  471.            QUICK START (continued)
  472.  
  473.    (.KTS files are the Key Translation Sequence files for terminals) This file
  474.    contains ascii versions of .KTS files.  ASC files are compiled into KTS
  475.    files using KTS.EXE.
  476.  
  477.  
  478. c) UTIL_SFX.EXE (Distributed)  UTIL.ZIP/ARJ (BBS)
  479.    UTIL_SFX contains several utilities that enhance the AceComm package.  Each
  480.    utility has it's .DOC file.
  481.  
  482.    It is suggested that UTIL_SFX be un-compressed inside a sub directory to the
  483.    AceComm directory
  484.  
  485.                 Example: C:\ACE\UTIL
  486.  
  487.         At the DOS prompt type:  md \ace\util
  488.         At the DOS prompt type:  copy UTIL_SFX.EXE \ace\util
  489.         At the DOS prompt type:  cd \ace\util
  490.         At the DOS prompt type:  UTIL_SFX
  491.         At the DOS prompt type:  cd \ace
  492.  
  493.  
  494.    MDMI.EXE Modem install utility, installs modem setup data directly into
  495.    ACE.PRM
  496.  
  497.  
  498.    CBF.EXE can compile direct FBL output into a FON file.
  499.  
  500.  
  501.    UBF.EXE can compile the USBBS listing into a FON file.  UBF can optionally
  502.    extract any area code from the USBBS listing.
  503.  
  504.  
  505.    IDX.EXE creates a very small index file so that AceComm can use a RAW
  506.    NODELIST file for mailer mode/file requests.
  507.  
  508.  
  509.    FBL.EXE creates a .BBS and .NOD file from the raw nodelist for a given NET
  510.    HOST
  511.  
  512.  
  513.    KTS.EXE compiles a Key Translation Sequence file from ascii to binary
  514.    format.
  515.  
  516.  
  517.    ANSI.EXE filters ANSI and AVATAR video control sequence codes from files.
  518.    ANSI.EXE can also be used to view the files.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.        Page 5              AceComm (tm) v 1.85
  526.  
  527.  
  528. Chapter 1  Introduction
  529.  
  530.            QUICK START (continued)
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.        Page 6              AceComm (tm) v 1.85
  585. Chapter 2  Modem Setup
  586.  
  587. Chapter 2  Modem Setup
  588.  
  589.  
  590.  
  591. High Speed Modems
  592. -----------------
  593. Modems with connect speeds of 9600 and above and offer data compression and or
  594. error correction are capable of transferring data at much faster rates that the
  595. rated connect speed for baud modem.
  596.  
  597. Todays modems including v.32 and v.32bis and beyond are all capable of data
  598. compression and offer data rates much faster than the 9600 connect speed.  To
  599. make proper use of these Hi-Speed modems the user needs understand a little
  600. about the modem.  Lets take a v.32bis modem as example.  V.32bis modems are
  601. very common and the price rivals that of 2400 baud modems of a few years ago.
  602. The V.32bis modem offers connect speeds up to 14400 and can transfer compressed
  603. data using various built in compression protocols at rates averaging and beyond
  604. 1650 cps for pre compressed files, and 2000-3000+ with un-compressed files.
  605.  
  606.  
  607. Locking the Port
  608. ----------------
  609. It is necessary to use what is referred to as a "locked port" when operating a
  610. 14400 v32 bis modem.  A "locked port" refers to having the software (AceComm)
  611. set the port at a rate faster than the highest possible connect speed, and then
  612. leave the port speed alone.  Modems setup to use a "locked port" will make the
  613. translation between connect speed and computer speed.  Here we refer to
  614. "connect speed" as the speed at which the modem connects to the other modem,
  615. and computer speed refers to the port setting.
  616.  
  617.  
  618. Locked Ports and Flow Control
  619. -----------------------------
  620. In order to support connect speeds of 14400, the modem needs be setup to use
  621. flow control.  Flow control enables the modem to be connected to the remote
  622. modem at a different speed than the computer-to-modem speed.  When modems
  623. connect at 14400 we refer to the connect speed as modem-to-modem speed.  14400
  624. is not a speed that the port (UART) can be set to.  Valid port speeds include
  625. 9600, 19200, 38400 and 57600.  To take advantage of 14400 connect speeds, the
  626. port needs be set to at least 19200.  AceComm supports setting the port to
  627. 19200, 38400, 57600, or 115200 and locking it here.  This is referred to as
  628. "Locking the port".  19200 is a preferable starting speed.  The faster you lock
  629. your port, the faster your computer needs to be in combination with a buffered
  630. (16550) UART.  An average 286/(386SX) 16 Mhz computer using a standard 16450
  631. UART chip can run a 14400 modem with the port locked at 19200.  Replace the
  632. 16450 single byte buffer UART chip with a 16550 16 byte buffer chip and the
  633. same computers can run the port at 38400.
  634.  
  635. When the port is set to 19200, the UART is setup to make data available to the
  636. computer software (AceComm) at 19200 bits per second (BPS).  This allows
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.        Page 7              AceComm (tm) v 1.85
  644.  
  645.  
  646. Chapter 2  Modem Setup
  647.  
  648. AceComm to fetch a character from the port at a faster rate than the modem can
  649. theoretically make the character available.  Theoretically because with todays
  650. data compression technology, Hi-Speed modem are capable of delivering text
  651. files at rates well above the connect speed.
  652.  
  653. The faster you set your port, the more quickly the UART assembles a character
  654. from the modem.  Thus faster port rates require faster computers and or
  655. buffered (16550) UART chips.
  656.  
  657. This is why we recommend 19200 a good starting point.  You may be able to
  658. download compressed files with the port locked at 38400, but an un-compressed
  659. file will be assembled so much faster with the modem's own compression services
  660. that errors may occur.  You may experience errors with un-compressed files, and
  661. normally do fine with compressed (.ARJ,.ZIP etc).  At 19200 you will probably
  662. be fine either way.  At 38400 and 56700 un-compressed data files can arrive
  663. much faster than your computer _may_ be capable of responding to.
  664.  
  665.  
  666. Modem Setup
  667. -----------
  668. Modem defaults may not always be ready for use with using a locked port rate.
  669. Most factory defaults are ready to go work with flow control and locked port
  670. rates.  The AceComm voice support line gets plenty of calls from users whose
  671. modems are not configured properly.
  672.  
  673. Lets examine a Supra v32 bis modem.  The AT commands below will work with
  674. almost all Hayes compatible v.32 / v.32bis modems.
  675.  
  676. The Supra modem can be set to a factory default which is suited to locked port
  677. rates by issuing the commands AT&F2 <CR>.  The command "AT&F2" loads a factory
  678. configuration for IBM compatible modems.  The "&F2" configuration is
  679. appropriate for error correction and data compression with Supra modems.
  680. Consult your modem manual for the proper &Fn param for your modem.
  681.  
  682.  
  683.  
  684. Generic Hayes Compatible Modem Setup
  685. ------------------------------------
  686.  
  687. &C1      DCD indicates carrier from modem
  688. &D2      Modem follows DTR signal
  689. &K3      RTS/CTS hardware flow control
  690. &Q5      Asynchronous reliable (error correction) mode
  691.  
  692. The above commands will work with most Hayes compatible modems.
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.        Page 8              AceComm (tm) v 1.85
  703.  
  704.  
  705. Chapter 2  Modem Setup
  706.  
  707. Modem INIT Strings
  708. ------------------
  709. Lets begin by making certain the modem is off hook and ready to receive an INIT
  710. string.
  711.  
  712.            ATH0^M
  713.  
  714. The AT command "H0" brings the modem off hook.  Most modems need be off hook to
  715. except AT commands.  "^M" is what AceComm translates into a <CR> character.
  716.  
  717. typing ATH1 <CR> from terminal mode puts the modem on hook. (busy)
  718. typing ATH0 <CR> from terminal mode puts the modem off hook.
  719.  
  720. We may have the modem off hook (busy) for any number reasons.  It is a good
  721. idea to begin our INIT string with ATH0^M and a small delay.  A small delay
  722. gives the modem a chance to respond before we send another INIT string .  We
  723. can create small delays in out INIT strings using ~ characters.  AceComm
  724. creates a 1/4 second delay for each occurrence of ~ character.
  725.  
  726. ATH0^M~~~~ATE0M0&C1&D2&K3&Q6
  727.  
  728. AceComm will append INIT strings with the command terminator.  Normally <CR> or
  729. as AceComm wants to see it ^M is the command terminator.  The above string
  730. includes 1 embedded command terminator but leaves AceComm to append the final
  731. <CR> to the end of the string.  The above modem INIT string is actually 2 init
  732. strings chained together.  The above modem INIT string should make most Hayes
  733. compatible modems ready to operate with FLOW control at a LOCKED port rate of
  734. 19200.
  735.  
  736.  
  737. Saving to NV RAM
  738. ----------------
  739. We do not need to include "&F2" in our init string every time.  It is likely
  740. that other AT commands will be included in your modem init string.  M0 turns
  741. the speaker off, certain tweaking to some of the S registers alters both
  742. performance and connect response strings.  Custom modem configurations can be
  743. saved to the modem using the "&W" command.  When this is done, the modem init
  744. string can become simply ATZ <CR>.  Follows is our INIT string with &W tacked
  745. on.
  746.  
  747. ATH0^M~~~~ATE0M0&C1&D2&K3&Q6&W
  748.  
  749. AceComm supports a SETUP field in the modem commands menu.  The setup field is
  750. designed for modem command lines that are to be used occasionally, and
  751. preferably to setup the modem with the "&W" AT command.  AT&F&W <CR> recalls
  752. the factory default configuration and saves it to nonvolatile memory.  This
  753. setup can then be recalled using ATZ <CR>.
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.        Page 9              AceComm (tm) v 1.85
  762.  
  763.  
  764. Chapter 2  Modem Setup
  765.  
  766. NV RAM is not designed to be written to everyday.  You want to configure your
  767. modem from time to time with &W and then use ATZ and whatever tweaks, as your
  768. normal INIT string.  You can get by just fine by simply using the default INIT
  769. string developed above, leaving off the &W command.  &W is for modem
  770. configurations that require several lines of INIT strings.  &W is an AT command
  771. you should know about, but may very well not ever need to use.
  772.  
  773.  
  774. AceComm's Modem Install Utility
  775. -------------------------------
  776. The AceComm package provides a modem install utility.  MDMI.EXE will display a
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.        Page 10              AceComm (tm) v 1.85
  821.  
  822. menu of modem brands along with the setup strings for each.  You may choose
  823. your modem type from the list.  MDMI.EXE will write directly to the ACE.PRM
  824. file (AceComm's binary configuration file).
  825.  
  826.  
  827.  
  828. Your modem reports a carrier present when you know you are off line.
  829.  
  830.       Type AT&C1  <ENTER> from terminal area
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.        Page 11              AceComm (tm) v 1.85
  881. Chapter 3  Terminal Area
  882.  
  883. Chapter 3  Terminal Area
  884.  
  885.  
  886. AceComm can be started from the DOS prompt, from a batch file, inside
  887. MS-Windows, DESQView, OS/2 etc.
  888.  
  889. When AceComm is started, it places the user in the "Terminal Area".  An
  890. optional flag located inside PRM-data Options(Terminal-Options) menu will have
  891. AceComm report directly into the "Phone List Area".
  892.  
  893. ----------------------------------------------------------------------------
  894. F10    │ File │ Setup │ Phone │ Transfer │ Users │ Help │  < >, ESC-quit
  895. Install on port 2
  896. Initializing Modem
  897.  
  898. ATE0&C1&D2
  899. OK
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  Off Line ║ 2,19200L,8N1 ║ Av/An ║ 08:54:19pm ║ ALT+V =KeyRef, F9= Help, F10
  907. ----------------------------------------------------------------------------
  908.  
  909. Terminal Area is the area in which all other areas are accessible, and where
  910. serial I/O takes place for the user.  Above is a sample of the AceComm TERMINAL
  911. screen upon start up.  A status line is placed at the bottom of the screen.
  912. The status line can be turned off from inside the configurations area.
  913.  
  914. "Off Line"
  915. AceComm checks the "Data Carrier Detect" signal from your serial port.  If you
  916. see "On Line", when you know you are "Off Line", type AT&C1 and press the enter
  917. key.  &C1 will instruct modern day modems to set the "Data Carrier Detect"
  918. signal to follow the "On Line" state.
  919.  
  920. "2,19200L,8N1"
  921. This is your "Line Control". Here we are on   port 2, at 19200 baud, L means
  922. the baud rate is "Locked", 8 data bits, No parity, 1 stop bit.
  923.  
  924. "Av/AN"
  925. Avatar and Ansi BBS video emulation.
  926.  
  927. "08:54:19pm"
  928. Your current time.
  929.  
  930. "ALT+V =KeyRef, F9= Help, F10"
  931. AceComm check 3 macros to see what key press they are assigned.
  932. <KeyRef_> macro
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.        Page 12              AceComm (tm) v 1.85
  940.  
  941.  
  942. Chapter 3  Terminal Area
  943.  
  944. <Help
  945.  
  946. F10    │ File │ Setup │ Phone │ Transfer │ Users │ Help │  < >, ESC-quit
  947.  
  948. "Off line" Status line
  949. ----------------------
  950.  Off Line ║ 2,19200L,8N1 ║ Av/An ║ 08:54:19pm ║ ALT+V =KeyRef, F9= Help, F10
  951.                                                 |              |         |
  952.                                                 |              |         |
  953.                                                 |              |     <TopBar>
  954.                                                 |              |
  955.                                                 |              <HelpMenu>
  956.                                                 |
  957.                                                 <KeyRef_> macro
  958.  
  959. <KeyRef_>
  960. <HelpMenu>
  961. <TopBar>
  962.  
  963. You can assign the three macros to different key presses, AceComm will always
  964. display the key press each macro is assigned. These are considered the quick
  965. reference macros, and their key press assignments will always be displayed at
  966. the right end of the status line.
  967.  
  968.  
  969. "On line" Status line
  970. ---------------------
  971.  On Line,2,19200L,8N1 ║ 00:00:24 ║ Av/An ║ 09:45:15pm ║ AceComm Support
  972.                         |          |                    |
  973.                         |          |                    System name
  974.                         |          Video type
  975.                         Time online
  976.  
  977.  
  978. Hold down the ALT key for a Pop Up key reference for keys available from the
  979. Terminal area.  Releasing the ALT key and the pop up reference disappears.
  980. The "Pop Up Reference" menu is called using the <KeyRef_> macro.  ALT V is
  981. assigned the <KeyRef_> macro in AceComm's default keyboard setup ACE_DEF.KBD
  982. file.  The AceComm key board is completely re definable
  983.  
  984.  
  985. (TERMINAL screen below with POP UP REFERENCE)
  986.  
  987.  
  988. ┌─KBD Macro Assignments, current file: ACE_DEF.KBD───────────────
  989. │>ALT-A <AutoScrGen_>
  990. │ ALT-B <ScrollBack_>
  991. │ ALT-C <CaptureFile_>
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.        Page 13              AceComm (tm) v 1.85
  999.  
  1000.  
  1001. Chapter 3  Terminal Area
  1002.  
  1003.            Pop Up Reference
  1004.  
  1005. │ ALT-D <PhoneList_>
  1006. │ ALT-E <SendStr> ATE^M <HostEcho>
  1007. │ ALT-F <FileList_>[DIR_DNLDS]
  1008. │ ALT-G <FileReq_>
  1009. │ ALT-H <MdmHangUp_>
  1010. │ ALT-I
  1011. │ ALT-J <DOSShell_>
  1012. │ ALT-K
  1013. │ ALT-L <RunProg> list
  1014. │ ALT-M <SendStr>ath1^M <ChgDir>mail\ged <RunProg>GOLDED <ChgDir>[DIR_START]
  1015. │ ALT-N <ChgDir>c:\mail\qm <RunProg>QM toss <ChgDir>[DIR_START]
  1016. │ ALT-O <PrmData_>
  1017. │ ALT-P <PrmData_>
  1018. │ ALT-Q
  1019. │ ALT-R <RunScript_>
  1020. │ ALT-S <ScrnDump_>
  1021. │ ALT-T <ScrnTag_>
  1022. └───(More) Display  Template  Quit  Help ┤<>v^├──────────────────
  1023.  
  1024. o The AceComm keyboard is macro driven
  1025.  
  1026. o The "Pop up Reference" displays each key press that has been assigned to a
  1027.   MACRO, or MACROS.
  1028.  
  1029. o Current .KBD file is displayed, AceComm supports unlimited .KBD files.
  1030.   Current .KBD filename is always displayed at the right side of the Terminal
  1031.   Area's status line.
  1032.  
  1033. AceComm's Keyboard is re definable.  Each key press can be re assigned a
  1034. different function, or set of functions.  To accomplish keyboard re definition,
  1035. AceComm uses descriptive text symbols called "macros".  Macros are enclosed
  1036. inside of angled brackets.
  1037.  
  1038. <PhoneList_>         this is the macro that runs the phone directory menu
  1039. <RunProg>LIST.COM    this macro can execute .COM and .EXE files, and search
  1040.                      the DOS path for them. The macro can also find the file's
  1041.                      .COM or .EXE extension.
  1042.                      <RunProg>LIST
  1043.  
  1044. Key board assignments are stored in a special binary file that uses .KBD file
  1045. extension.
  1046.  
  1047. The Pop Up Reference menu displays the current ".KBD" file key assignments.
  1048. A ".KBD" file contains a copy of all key-press assignments.  AceComm supports
  1049. multiple ".KBD" files.  Each key press combination can be assigned to one or
  1050. more macros.  AceComm allows the user to re define the keyboard functions if so
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.        Page 14              AceComm (tm) v 1.85
  1058.  
  1059.  
  1060. Chapter 3  Terminal Area
  1061.  
  1062.            Pop Up Reference (continued)
  1063.  
  1064. desired.  A rich macro library of functions and services are supplied.  A
  1065. complete macro listing with descriptions is contained in AceComm manual.
  1066.  
  1067. - M)ore or <CR> will display the next key set at top of screen.
  1068.  
  1069. - Display toggles the display from a text description and the actual macro
  1070.   assignments.  Not all macros have a text description included.  Text
  1071.   descriptions are included for the internal services which require local user
  1072.   input from the key board.
  1073.  
  1074.   The key press is displayed to the left, with it's MACRO assignment to the
  1075.   right.  The example below shows the MACRO for AceComm's configurations area
  1076.   is assigned to ALT-P.
  1077.  
  1078.      ALT-P <PrmData_>              <= MACRO assign
  1079.      ALT-P Configuration Area      <= descriptive text
  1080.  
  1081. - Template allows you to print a list of keys that have MACRO assignments.  The
  1082.   default filename is "PRN".  You may find it handy to print to a FILE,
  1083.   "KEY.PRN or similar, this way you can format the TEMPLATE, for a more custom
  1084.   print job.
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.        Page 15              AceComm (tm) v 1.85
  1117. Chapter 4  PRM-data Menus Area
  1118.  
  1119. Chapter 4  PRM-data Menus Area
  1120.  
  1121.  
  1122. The configuration area's main screen. Menus exist here nested several layers
  1123. deep.
  1124.  
  1125. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1126. ░░░░░░░░░░░╔═PRM-data Menus Area══════════════════╗░░░░░░░░░
  1127. ░░░░░░░░░░░║═AutoSave is On═══════════════════════║░░░░░░░░░
  1128. ░░░░░░░░░░░║>Serial Port/Modem Setup         │ │  ║░░░░░░░░░
  1129. ░░░░░░░░░░░║ Dialing Options                 │P│  ║░░░░░░░░░
  1130. ░░░░░░░░░░░║ Terminal Area Options           │R│  ║░░░░░░░░░
  1131. ░░░░░░░░░░░║ Internal Protocol Options       │M│  ║░░░░░░░░░
  1132. ░░░░░░░░░░░║ Auto Engage Protocols           │-│  ║░░░░░░░░░
  1133. ░░░░░░░░░░░║ Auto Log On Technology          │d│  ║░░░░░░░░░
  1134. ░░░░░░░░░░░║ IEMSI Data                      │a│  ║░░░░░░░░░
  1135. ░░░░░░░░░░░║ Point / Mailer                  │t│  ║░░░░░░░░░
  1136. ░░░░░░░░░░░║ Auto Answer Setups              │a│  ║░░░░░░░░░
  1137. ░░░░░░░░░░░║ Event Schedules                 │ │  ║░░░░░░░░░
  1138. ░░░░░░░░░░░║ KeyBoard Redefinition           │A│  ║░░░░░░░░░
  1139. ░░░░░░░░░░░║ Directories in Use Menu         │r│  ║░░░░░░░░░
  1140. ░░░░░░░░░░░║ External Programs Setup         │e│  ║░░░░░░░░░
  1141. ░░░░░░░░░░░║ User Definable Menus            │a│  ║░░░░░░░░░
  1142. ░░░░░░░░░░░║ Colors, Sounds, Screen          │ │  ║░░░░░░░░░
  1143. ░░░░░░░░░░░╚═══(Select) Write  Quit  Help ┤<>v^├══╝░░░░░░░░░
  1144. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1145.  
  1146.  
  1147. o MACRO for this menu is: <PrmData_> default key press assign is to ALT P
  1148.  
  1149. o All PRM-data changes are auto-saved when Auto-Save flag is "ON" (default)
  1150.  
  1151. o Each sub-menu contains context sensitive HELP
  1152.  
  1153. Virtually any data contained inside the ACE.PRM file is accessible and
  1154. configurational from the PRM-data area.
  1155.  
  1156.  
  1157.  
  1158. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1159. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1160. ░░░░░░░░░░░╔═Terminal Area Options══════════════════════════╗░░░░░░
  1161. ░░░░░░░░░░░║>Telephone book on start up           No        ║░░░░░░
  1162. ░░░░░░░░░░░║ Allow enhanced keyboard detection    Yes       ║░░░░░░
  1163. ░░░░░░░░░░░║ Allow mouse detection                Yes       ║░░░░░░
  1164. ░░░░░░░░░░░║ Auto Save Changes                    On        ║░░░░░░
  1165. ░░░░░░░░░░░║ Screen Saver timeout value (minutes) 3         ║░░░░░░
  1166. ░░░░░░░░░░░║ Screen Saver if Data Carrier Detect  No        ║░░░░░░
  1167. ░░░░░░░░░░░║ Keep Log file                        On        ║░░░░░░
  1168. ░░░░░░░░░░░║ Log modem response while off line    No        ║░░░░░░
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.        Page 16              AceComm (tm) v 1.85
  1176.  
  1177.  
  1178. Chapter 4  PRM-data Menus Area
  1179.  
  1180.            Terminal Area Options
  1181.  
  1182. ░░░░░░░░░░░║ All Sounds Override <> Sounds are    On        ║░░░░░░
  1183. ░░░░░░░░░░░║ Ignore DCD on INIT & Dial            No        ║░░░░░░
  1184. ░░░░░░░░░░░║ DTR state when quitting AceComm      On        ║░░░░░░
  1185. ░░░░░░░░░░░║ Printer rows                         60        ║░░░░░░
  1186. ░░░░░░░░░░░║═Sub Menus══════════════════════════════════════║░░░░░░
  1187. ░░░░░░░░░░░║ Terminal Area Options                          ║░░░░░░
  1188. ░░░░░░░░░░░║ Default Video Emulation              Av/An     ║░░░░░░
  1189. ░░░░░░░░░░░║ Control Memory Use                             ║░░░░░░
  1190. ░░░░░░░░░░░╚═══(Edit) Quit  Help ┤<>v^├═════════════════════╝░░░░░░
  1191. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1192. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1193.  
  1194. o The controls are enable/disable flags, some of which can also contain a value
  1195.   for timers.
  1196.  
  1197. o Sub menus contain more categorized controls
  1198.  
  1199. Most controls are a series of flags which tell AceComm when to use some of the
  1200. features, and when not to.  Flags with the ON/OFF status are toggles, and will
  1201. be toggled here in this menu.
  1202.  
  1203. Notice the "Screen Saver" flag description contains the number 5,
  1204. rather than an ON/OFF.  Selecting Screen Saver mode 0 = OFF.
  1205.  
  1206.  
  1207. Telephone book on start up              No
  1208. --------------------------
  1209.   AceComm can go directly into the Phone List Area on start up.
  1210.  
  1211.  
  1212. Allow enhanced keyboard detection       Yes
  1213. ---------------------------------
  1214.   AceComm will detect and use enhanced BIOS keyboard functions.  Some systems
  1215.   may not fully support this mode properly.  This flag allows locking out
  1216.   AceComm's use of enhanced BIOS keyboard functions.
  1217.  
  1218.  
  1219. Allow mouse detection                   Yes
  1220. ---------------------
  1221.   Setting this to "NO" will cause AceComm to act as if a mouse is non existent,
  1222.   the mouse driver is never initialized, no mouse menu is presented in the
  1223.   Terminal Area.
  1224.  
  1225.  
  1226. Auto Save Changes                       On
  1227. -----------------
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.        Page 17              AceComm (tm) v 1.85
  1235.  
  1236.  
  1237. Chapter 4  PRM-data Menus Area
  1238.  
  1239.            Terminal Area Options (continued)
  1240.  
  1241.   When "ON" AceComm will save PRM-data changes to the ACE.PRM file.  When "OFF"
  1242.   the prompt inside the main PRM-data menu must be selected for PRM-data
  1243.   changes to be recorded to file.  This pertains to actual PRM-data below the
  1244.   menu system data.  Menu area attributes are ALWAYS SAVED, with exception to
  1245.   "Mass Menu Area" changes, these must be affected using the appropriate
  1246.   selection from inside "Mass Menu".
  1247.  
  1248.  
  1249. Screen Saver timeout value (minutes)    3
  1250. ------------------------------------
  1251.   Screen Blanking function.  Screen Saver can be set from 0 - 10.  Values above
  1252.   0 are minutes without a key press to AceComm blanking the screen.  Screen is
  1253.   restored with a key press.  Un-blank-key-press is valid.  Use ALT alone for
  1254.   non-destructive key press to un-blank the screen.
  1255.  
  1256.   See also "Screen Saver if Data Carrier Detect" from Terminal Area Options
  1257.   menu.
  1258.  
  1259.  
  1260. Screen Saver if Data Carrier Detect     No
  1261. -----------------------------------
  1262.   Screen Blanking service disabled during modem status DCD bit detected to be
  1263.   ASSERTED.
  1264.  
  1265.  
  1266. Keep Log file                           On
  1267. -------------
  1268.   Toggle AceComm use logging ON/OFF.
  1269.  
  1270.  
  1271. Log modem response while off line       No
  1272. ---------------------------------
  1273.   You can trap caller ID with this.
  1274.   AceComm can log modem response strings that come in.  This flag will tells
  1275.   AceComm if it should log the responses.  This is for off line only.  This
  1276.   flag is most use full when you want to know when your phone rings, AceComm
  1277.   will TIME STAMP PRM-data Area MDM_RESPONSE_RING responses strings.  Many
  1278.   modem ROMS are now featuring caller ID.  Modems that have caller ID ability
  1279.   will be able to present to the terminal screen the caller ID info, if
  1280.   available.  This information will also be logged along with the TIME STAMPED
  1281.   "RING".
  1282.  
  1283.  
  1284. All Sounds Override <> Sounds are       On
  1285. ---------------------------------
  1286.   Toggle, enable/disable all sounds. Master override.
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.        Page 18              AceComm (tm) v 1.85
  1294.  
  1295.  
  1296. Chapter 4  PRM-data Menus Area
  1297.  
  1298.            Terminal Area Options (continued)
  1299.  
  1300.  
  1301.  
  1302. Ignore DCD on INIT & Dial               No
  1303. -------------------------
  1304.   If you must, you can tell AceComm your modem does not properly assert DCD.
  1305.  
  1306.  
  1307. DTR state when quitting AceComm         On
  1308. -------------------------------
  1309.   Will AceComm drop DTR when the <EndAceComm> macro is run.  Most modems will
  1310.   by default, drop carrier along with a drop in DTR.  DTR is a bit in the modem
  1311.   control register of the UART.  Setting this to "YES" will cause AceComm to
  1312.   drop DTR when ever <EndACECOMM> [n] MACRO is executed.
  1313.  
  1314.  
  1315. Printer rows                            60
  1316. ------------
  1317.    When AceComm does print, key reference, this will allow a form feed to
  1318.    be sent every "rows" times.
  1319.  
  1320.  
  1321.  
  1322.  
  1323. ╔═Terminal Screen Options═════════════════════════╗
  1324. ║>Status line                              Yes    ║
  1325. ║ Terminal Area screen color (TTY mode)    7      ║
  1326. ║ Strip high bit from incoming             Off    ║
  1327. ╚═══ Edit  Quit  Help ┤<>v^├══════════════════════╝
  1328.  
  1329.  
  1330. Status line                              On
  1331. -----------
  1332.   Toggle AceComm 's STATUS LINE On/Off
  1333.  
  1334.   Notes: AutoScrGen (Tm) will assert the STATUS LINE, and restore it on when
  1335.          through.  The RunScript function will do the same.
  1336.  
  1337.  
  1338. Terminal Area screen color (TTY mode)    7
  1339. -------------------------------------
  1340.   This setting allows changing the Terminal Screen color that is initially
  1341.   active when AceComm is started.  The color will remain constant through TTY
  1342.   video emulation.
  1343.  
  1344.  
  1345. Strip high bit from incoming             Off
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.        Page 19              AceComm (tm) v 1.85
  1353.  
  1354.  
  1355. Chapter 4  PRM-data Menus Area
  1356.  
  1357.            Terminal Screen Options
  1358.  
  1359. ----------------------------
  1360.   "Off" data received from the modem is un altered.  "ON" data is stripped of
  1361.   any bits above the decimal value 128.
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367. Default Video Emulation                  Av/An
  1368. -----------------------
  1369.   This selection brings up another menu.  The menu displays the available video
  1370.   terminal emulation modes.  Along with their associated KTS files.  This
  1371.   setting affects the default video terminal setting for AceComm.  Individual
  1372.   FON RECORDS contain their own video terminal settings.
  1373.  
  1374.  
  1375.  
  1376.  
  1377. <-HELP_END->
  1378.  
  1379. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1380. ░░░╔═D:\ACE\ACE.PRM══════════════════╗░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1381. ░░░║╔═General Controls/Menus════════════════════════╗░░░░░░░░░░░░
  1382. ░░░║║                                               ║░░░░░░░░░░░░
  1383. ░░░║║                                               ║░░░░░░░░░░░░
  1384. ░░░║║                                               ║░░░░░░░░░░░░
  1385. ░░░║║╔═Control Memory Use═══════════════════════╗   ║░░░░░░░░░░░░
  1386. ░░░║║║>XMS (kb) ok to use           64          ║   ║░░░░░░░░░░░░
  1387. ░░░║║║ Scroll Back (kb) to use      64          ║   ║░░░░░░░░░░░░
  1388. ░░░║║║ Swap for <RunProg>           On          ║   ║░░░░░░░░░░░░
  1389. ░░░║║║ Swap for <DOSShell_>         On          ║   ║░░░░░░░░░░░░
  1390. ░░░║║║═Current Memory Use═══════════════════════║   ║░░░░░░░░░░░░
  1391. ░░░║║║ XMS allocated                65536       ║═══║░░░░░░░░░░░░
  1392. ░░░║║║ XMS free at load             2424832     ║   ║░░░░░░░░░░░░
  1393. ░░░╚║║ ACE.EXE load                 227040      ║   ║░░░░░░░░░░░░
  1394. ░░░░║║ Scroll Back allocated        65536       ║   ║░░░░░░░░░░░░
  1395. ░░░░║║ PRM file  allocated          36025       ║   ║░░░░░░░░░░░░
  1396. ░░░░╚║ Rx buffer allocated          8192        ║═══╝░░░░░░░░░░░░
  1397. ░░░░░║ Tx buffer allocated          256         ║░░░░░░░░░░░░░░░░
  1398. ░░░░░╚═══ Select  Quit  Help ┤<>v^├═════════════╝░░░░░░░░░░░░░░░░
  1399. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1400.  
  1401.  
  1402. o With version 1.7, AceComm begins managing memory usage.
  1403.  
  1404. o AceComm can swap the scroll back buffer memory to XMS prior to allocating
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.        Page 20              AceComm (tm) v 1.85
  1412.  
  1413.  
  1414. Chapter 4  PRM-data Menus Area
  1415.  
  1416.            Memory Manager
  1417.  
  1418.   large chunks of memory for other operations.
  1419.  
  1420. o EMS will be supported in the next release.
  1421.  
  1422. o XMS and EMS are supported for the SWAP functions.
  1423.  
  1424.  
  1425. XMS (kb) ok to use
  1426.  
  1427.   AceComm's internal memory manager can save overall memory requirements by
  1428.   swapping some internal data to XMS memory when about to perform another
  1429.   memory hungary task.
  1430.  
  1431.  
  1432. Scroll Back (kb) to use
  1433.  
  1434.   Up to 64 kb (64 x 1024) memory can be used for the back buffer.  Future
  1435.   versions of AceComm will begin allowing multiple 64 kb memory be used for
  1436.   scroll back buffer.  The first 64 kb memory is conventional memory.
  1437.  
  1438.  
  1439. Swap for <RunProg>                       On
  1440.  
  1441.   XMS, EMS, DISK swapping for the AceComm executable will take place when this
  1442.   flag is set "ON".  When SWAPPING is active, AceComm 's SIO is deactivated
  1443.   while <RunProg> MACRO is active.
  1444.  
  1445.   Notes: AceComm is currently using Ralf Brown's SWAP functions for the SWAP
  1446.          service.  SWAP is the only code inside AceComm executable that is not
  1447.          written entirely by MGP Programming Services.  SWAP has proven to be
  1448.          the most dependable code of this type that has been tested in our
  1449.          executable files.  MGP Software would like to thank Ralf Brown for
  1450.          permission to use his SWAP code in our products.
  1451.  
  1452.  
  1453. Swap for <DOSShell_>              On
  1454.  
  1455.   XMS, EMS, DISK swapping for the AceComm executable will take place when this
  1456.   flag is set "ON".  When SWAPPING is active, AceComm 's SIO is deactivated
  1457.   while <DOSShell_> MACRO is active.
  1458.  
  1459.   Notes: The Notes for <RunProg> apply to this MACRO
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.        Page 21              AceComm (tm) v 1.85
  1471.  
  1472.  
  1473. Chapter 4  PRM-data Menus Area
  1474.  
  1475.            Internal Protocol Options
  1476.  
  1477.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1478.   ░░░░░░░░╔═Internal Protocol Options══════════════╗░░░░
  1479.   ░░░░░░░░║>Auto Engage                       Yes  ║░░░░
  1480.   ░░░░░░░░║ File Rename                       Yes  ║░░░░
  1481.   ░░░░░░░░║ File Resume                       Yes  ║░░░░
  1482.   ░░░░░░░░║ Bell after internal protocol      3    ║░░░░
  1483.   ░░░░░░░░║ Time release from protocol        No   ║░░░░
  1484.   ░░░░░░░░║ Ascii protocol EOF character      26   ║░░░░
  1485.   ░░░░░░░░╚═══(Select) Quit  Help ┤<>v^├═══════════╝░░░░
  1486.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1487.  
  1488. Auto Engage                              Yes
  1489.  
  1490.   Activate/deactivate Auto engage sequence triggers & Associated AutoM
  1491.   MACROS.  (enable/disable auto downloads) Does not affect auto log on.
  1492.  
  1493.  
  1494. File Rename                              Yes
  1495.  
  1496.   For internal Zmodem.  Rename "Yes" existing files when last modification
  1497.   time/date don't match.  AceComm will create a new filename.  When file times
  1498.   don't match, we can assume that although the filenames are the same, they
  1499.   were created at different times, and probably contain different data.
  1500.  
  1501.   Example:
  1502.           The file "114-35.QWK" exists in our receive directory.  The incoming
  1503.           filename is "114-35.QWK" also.  AceComm's internal zmodem will then
  1504.           compare file times and if they match, it is safely these files are
  1505.           the same and a file size check is done to see if we can resume the
  1506.           download.
  1507.  
  1508.           If the file times don't match, AceComm's internal zmodem will try and
  1509.           create a filename "114-35.QW0", if this filename exists, "114-35.QW1"
  1510.           etc.  Thus we can have several *same* filenames in our receive
  1511.           directory without overwriting them.
  1512.   Example:
  1513.           You download the "allfiles.lst" from the same BBS every week.  The
  1514.           filename is always the same, the file times differ.  AceComm will
  1515.           name duplicates names as "allfiles.lst", "allfiles.ls0",
  1516.           "allfiles.ls1" etc.
  1517.  
  1518.  
  1519. File Resume                              Yes
  1520.  
  1521.   For internal Zmodem.  Resume "Yes" existing files, data is appended to the
  1522.   file, "OFF", the file is created new, any existing file of the same name is
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.        Page 22              AceComm (tm) v 1.85
  1530.  
  1531.  
  1532. Chapter 4  PRM-data Menus Area
  1533.  
  1534.            Internal Protocol Options (continued)
  1535.  
  1536.   over written.  *If* the file modification time matched.  Otherwise with File
  1537.   Rename function would have created it's unique filename.  In the event the
  1538.   file sizes are same, the file is skipped when the resume flag is set to yes.
  1539.  
  1540.   Example:
  1541.           You started down loading a file and were interrupted for some reason
  1542.           aborting the download.  You log back on at a later time, and using
  1543.           Acecomm's internal zmodem begin to download the file once again.
  1544.           AceComm's internal zmodem will see if the file times match, and
  1545.           considers the to be the same file.  Internal zmodem will tell the
  1546.           host zmodem to begin sending from the position where the file was
  1547.           aborted from.  The file can be "Resumed", thus saving the time
  1548.           involved in down loading the entire file all over again.
  1549.  
  1550.  
  1551. Ring bell after internal protocol        3
  1552.  
  1553.   Internal protocols will sound an alarm before returning to Terminal Area.  A
  1554.   value of "0" disables any sound after internal protocols.  A value of "1"
  1555.   plays a Victory tune.  Values from 2-30 become seconds to sound the internal
  1556.   bell.  See also <RingBell> 5 MACRO
  1557.  
  1558.  
  1559. Time release from protocol               No
  1560.  
  1561.   Time slices for Windows/ OS/2, DV, and DOS are supported.  This flag applies
  1562.   to the DV and DOS time releases.  Releasing time to Windows/ OS/2 using the
  1563.   interrupt 2fh function causes so many missed interrupts that AceComm never
  1564.   releases int 2fh time slices during an internal protocol function.  Time
  1565.   slices are otherwise given up generously.
  1566.  
  1567. Ascii protocol EOF character            26
  1568.  
  1569.    Ascii receive protocol will consider the file received when this character
  1570.    comes along.  26 is the standard character marking "End Of File" with DOS
  1571.    based text files.
  1572.  
  1573.  
  1574.  
  1575.  
  1576. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1577. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1578. ░░░░░░░░░░╔═Dialing Options═══════════════════════════════╗░░░░░
  1579. ░░░░░░░░░░║>Inter byte delay                         4    ║░░░░░
  1580. ░░░░░░░░░░║ Modem Response Timeout when dialing      65   ║░░░░░
  1581. ░░░░░░░░░░║ Seconds between re-dial                  1    ║░░░░░
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.        Page 23              AceComm (tm) v 1.85
  1589.  
  1590.  
  1591. Chapter 4  PRM-data Menus Area
  1592.  
  1593.            Dialing Area Options
  1594.  
  1595. ░░░░░░░░░░║ DTR state between re-dial                Off  ║░░░░░
  1596. ░░░░░░░░░░║ Ring BELL on Dial/Connect                1    ║░░░░░
  1597. ░░░░░░░░░░║ Hide PWD when dialing                    No   ║░░░░░
  1598. ░░░░░░░░░░║═Menus═════════════════════════════════════════║░░░░░
  1599. ░░░░░░░░░░║ Phone Number Modifiers                        ║░░░░░
  1600. ░░░░░░░░░░╚═══(Select) Quit  Help ┤<>v^├══════════════════╝░░░░░
  1601. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1602. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1603.  
  1604. Inter Byte Delay                         1
  1605.  
  1606.   Add (value x 55 millisecond) delay between modem command characters.  With a
  1607.   value of '0' modem command strings are sent just as fast as the UART's
  1608.   Transmit Hold Register is Empty (THRE).  (I've observed Supra modems behave
  1609.   much better using a value of 1 for inter byte delay when in continuous
  1610.   re-dial)
  1611.  
  1612.  
  1613. Modem Response Timeout when dialing      60
  1614.  
  1615.   Master timeout when dialing.  Overrides your modem's own S7 register.
  1616.  
  1617.   Notes: It may be best to set this value several seconds above your modem's S7
  1618.          register.
  1619.  
  1620.  
  1621. Seconds between re dials                 1
  1622.  
  1623.   AceComm will pause this many seconds between receiving a modem response
  1624.   string, or timing out, and sending the next dial string to the modem.  The
  1625.   variable can be toggled from 0 seconds to 90 seconds.
  1626.  
  1627.  
  1628. DTR state between re-dial                Off
  1629.  
  1630.    If DTR will be set to LO between re-dial attempts.
  1631.  
  1632.  
  1633. Ring BELL on Dial/Connect                1
  1634.  
  1635.   Seconds to ring BELL on successful detection of either DCD or a connect
  1636.   message response from the modem.
  1637.  
  1638.  
  1639. Re-dials in mail mode                    64
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.        Page 24              AceComm (tm) v 1.85
  1648.  
  1649.  
  1650. Chapter 4  PRM-data Menus Area
  1651.  
  1652.            Dialing Area Options (continued)
  1653.  
  1654.    Number of re-dials before giving up to terminal mode.  A mail schedule will
  1655.    go back into the dialer every few minutes anyway.  If the scheduled mail
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.        Page 25              AceComm (tm) v 1.85
  1707.  
  1708.    event ends, re-dial continues for this setting times.
  1709.  
  1710. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1711. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1712. ░░░░░░░░░░╔═Phone Number Modifiers═════════════════════════════════╗░░░░
  1713. ░░░░░░░░░░║═Translate══════════════════════════════════════════════║░░░░
  1714. ░░░░░░░░░╔║ Translate 1-602-846-4563 1-602-846-2940                ║░░░░
  1715. ░░░░░░░░░║║ Translate 1-602-292-0997 1-602-292-0997                ║░░░░
  1716. ░░░░░░░░░║║ Translate                                              ║░░░░
  1717. ░░░░░░░░░║║ Translate                                              ║░░░░
  1718. ░░░░░░░░░║║ Translate 1-602-                                       ║░░░░
  1719. ░░░░░░░░░║║═Long Distance Detect═══════════════════════════════════║░░░░
  1720. ░░░░░░░░░║║>Long Dist 1-                                           ║░░░░
  1721. ░░░░░░░░░║║═Replaceable════════════════════════════════════════════║░░░░
  1722. ░░░░░░░░░║║ !                                                      ║░░░░
  1723. ░░░░░░░░░╚║ @                                                      ║░░░░
  1724. ░░░░░░░░░░║ #                                                      ║░░░░
  1725. ░░░░░░░░░░║ $                                                      ║░░░░
  1726. ░░░░░░░░░░╚═══(Edit) Quit ┤<>v^├═══════════════════════════════════╝░░░░
  1727. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1728. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1729.  
  1730. AceComm will use Dial statements to modify phone numbers.
  1731.  
  1732. Translate statements are required when using point mail functions, because
  1733. NODELIST phone numbers contain area codes.  AceComm uses Translate statements
  1734. to know how to modify phone numbers.
  1735.  
  1736. Translate
  1737.  
  1738.    String on left is replace with string on right
  1739.    Example for changing long distance numbers into local numbers
  1740.       1-602-    |
  1741.       |         |
  1742.       |         |____________________
  1743.       |                             |
  1744.       This will be replaced with this, stripping 1-602- from phone numbers
  1745.       Note: LDF flag must be set ON for any Fon.Records you want Translation
  1746.             to be used with. LDF can be set ON or OFF for an entire FON file
  1747.             all at once from inside the "Mass Updates" menu located inside
  1748.             the Phone list menu area.
  1749.  
  1750.  
  1751. Long Distance Detect
  1752.  
  1753.    Used with Point Mail dialing, AceComm will consider any phone numbers that
  1754.    begin with these characters to be long distance numbers.
  1755.    Example:  1-
  1756.    If 1- are the first two characters in a phone number, AceComm will require
  1757.    that the current event schedule have ",LF" flag.
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.        Page 26              AceComm (tm) v 1.85
  1767.  
  1768.  
  1769. Chapter 4  PRM-data Menus Area
  1770.  
  1771.            Dialing Area Options (continued)
  1772.  
  1773. Replaceables
  1774.    !        These are symbols which can represent a string of numbers and or
  1775.    @        dial string modifiers. A symbol will be replace with the string
  1776.    #        it represents.
  1777.    $
  1778.  
  1779.    AceComm supports two delays. A   ~   character causes a 1 second delay
  1780.                                 A   `   character causes a 5 second delay
  1781.                                 Note the difference between ` and '
  1782.  
  1783.  
  1784.  
  1785.  
  1786. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1787. ░░░░░┌───Serial Port/Modem Setup────────────┐░░
  1788. ░░░░░│ Port Number Select      2            │░░
  1789. ░░░░░│ Line Control Setup      19200L,8N1   │░░
  1790. ░░░░░│ Modem Response Strings               │░░
  1791. ░░░░░│>Modem Command Strings                │░░
  1792. ░░░░░│ Modem Control Setup                  │░░
  1793. ░░░░░└─ Select  Quit ┤<>v^├─────────────────┘░░
  1794. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1795.  
  1796.  
  1797. o The "Serial Port Setup Menu" contains sub-menus for all of AceComm's serial
  1798.   port and serial port related configurations.
  1799.  
  1800. o Information presented to the right of menu selections are current settings.
  1801.   The 'L' appended to BAUD indicates LOCK BAUD is SET "ON".  If you run a
  1802.   Hi-Speed modem, then you will be leaving LOCKBAUD set "ON".
  1803.  
  1804.  
  1805. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1806. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1807. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  1808. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  1809. ░░░░░░░░░░░░░░░░░░░░░│ ┌─Port          Address IRQ   Detected ───────┐░░░░░░░░
  1810. ░░░░░░░░░░░░░░░░░░░░░│┌│>1             03F8h    4      Yes           │░░░░░░░░
  1811. ░░░░░░░░░░░░░░░░░░░░░│││ 2             02F8h    3   In use           │░░░░░░░░
  1812. ░░░░░░░░░░░░░░░░░░░░░│││ 3             03E8h    4       No           │░░░░░░░░
  1813. ░░░░░░░░░░░░░░░░░░░░░│││ 4             02E8h    3       No           │░░░░░░░░
  1814. ░░░░░░░░░░░░░░░░░░░░░│││ 5             0230h    4       No           │░░░░░░░░
  1815. ░░░░░░░░░░░░░░░░░░░░░│││ 6             0238h    4       No           │░░░░░░░░
  1816. ░░░░░░░░░░░░░░░░░░░░░│└│ 7             0240h    4       No           │░░░░░░░░
  1817. ░░░░░░░░░░░░░░░░░░░░░│ │ 8             0248h    4       No           │░░░░░░░░
  1818. ░░░░░░░░░░░░░░░░░░░░░│ │─ Other stuff ───────────────────────────────│░░░░░░░░
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.        Page 27              AceComm (tm) v 1.85
  1826.  
  1827.  
  1828. Chapter 4  PRM-data Menus Area
  1829.  
  1830.            Port Select/Configure
  1831.  
  1832. ░░░░░░░░░░░░░░░░░░░░░│ │ RBuf          8192                          │░░░░░░░░
  1833. ░░░░░░░░░░░░░░░░░░░░░│ │ TBuf          256                           │░░░░░░░░
  1834. ░░░░░░░░░░░░░░░░░░░░░│ │ FIFO trigger  8                             │░░░░░░░░
  1835. ░░░░░░░░░░░░░░░░░░░░░└─│ TX            Off                           │░░░░░░░░
  1836. ░░░░░░░░░░░░░░░░░░░░░░░│ CTS/RTS       On                            │░░░░░░░░
  1837. ░░░░░░░░░░░░░░░░░░░░░░░│ XON/XOFF      Off                           │░░░░░░░░
  1838. ░░░░░░░░░░░░░░░░░░░░░░░└─ Install  Edit  Quit  Help ┤<>v^├───────────┘░░░░░░░░
  1839. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1840.  
  1841. Port numbers are merely symbolic for identification.  Port addresses and the
  1842. Interrupt ReQuest line for the address is configurational.
  1843.  
  1844.       Install option, AceComm will close the active port and install it's SIO
  1845.   on the port selected.  MDM_INIT string is sent to modem.
  1846.  
  1847.       Edit option, you will be prompted for port address and IRQ.  Address is a
  1848.   HEX number.  Entering a decimal value will fail.
  1849.  
  1850.       Rbuf/Tbuf are the buffer size used for serial I/O.  Normally there won't
  1851.   be any advantage to raising the TBuf size.  RBuf size will be adequate at
  1852.   about 1024 bytes for all normal use.  The larger value (default) will allow
  1853.   storage of incoming during Back buffer, Tagger etc.  RBuf range is from 1k to
  1854.   32k, TBuf 128 bytes to 32k.  The Zmodem sending unit's window size is equal
  1855.   to TBuf size.  Window size is not data-frame size.  Window size means "how
  1856.   much data do we let build up into the TX buffer at any one time.  RBuf/TBuf
  1857.   can be changed at any time, on line or not.  It is recommended that the HOST
  1858.   be still when re-sizing RBuf/TBuf.  RBuf/TBuf changes take immediate affect.
  1859.  
  1860.       FIFO trigger is the number of bytes buffered before a First In First Out
  1861.   UART chip will alert the CPU by way of interrupt.  FIFO UART operation is
  1862.   automatically enabled when a FIFO UART is detected.  AceComm always checks
  1863.   for FIFO UART presence whenever installing onto a PORT.  FIFO trigger level
  1864.   changes take immediate affect.  Trigger level of "1" affectively disables the
  1865.   FIFO affect.  The setting for "8" will give the best performance under
  1866.   multi taskers.
  1867.  
  1868.       TX is a flag that tells AceComm to use interrupt driven output.
  1869.   Interrupt driven input is always on.  The TX toggle takes immediate affect.
  1870.   If you FAST computer/modem setup is capable of overwhelming the other end
  1871.   when sending data, toggling TX "OFF" may improve the situation.
  1872.  
  1873.       CTS/RTS hardware handshaking / FLOW control Hardware handshaking may
  1874.   normally be left ON (default).  High speed modems using fast data rates and
  1875.   typically locked port rates will require software to use FLOW control.
  1876.  
  1877.       XON/XOFF software handshaking / FLOW control Many HOST software will
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.        Page 28              AceComm (tm) v 1.85
  1885.  
  1886.  
  1887. Chapter 4  PRM-data Menus Area
  1888.  
  1889.            Port Select/Configure (continued)
  1890.  
  1891.   recognize XON/XOFF FLOW control.  You may need software handshaking enabled
  1892.   for proper FLOW control while performing ascii uploads.
  1893.  
  1894.  
  1895.  
  1896.     ╔═══ Serial Port Setup Menu ═══════════╗
  1897.     ║ Port Number Select      1            ║
  1898.     ║╔═ UART Line Control ═══════════════╗ ║
  1899.     ║║>Data Bits          8              ║ ║
  1900.     ║║ Parity             None           ║ ║
  1901.     ║║ Stop Bits          1              ║ ║
  1902.     ║║ Max/Lock Baud Rate 19200          ║ ║
  1903.     ║║ Lockbaud           On             ║ ║
  1904.     ╚╚═ Select  Quit  Help ══════════════╝═╝
  1905.  
  1906.  
  1907. The UART's line control register can be set for several different data
  1908. arrangements.  Most common being 8 data bits, no parity bit, 1 stop bit.  Most
  1909. BBS systems will use the 8N1 configuration.  The UART uses the line control
  1910. information when assembling incoming bits into a byte.  Setting this
  1911. information from the PRM-data area, the format is stored in the default
  1912. settings for AceComm to use.  When you look at the FON directory records you
  1913. will see that each record stores it's personal line control setting to be used
  1914. when dialing the record.  Data format is saved with each individual record in
  1915. the record's .FON file.  When using AceComm in HOST mode the default setting
  1916. will be used.  AceComm retains the default line control register setting in the
  1917. ACE.PRM file.  FON record line control settings are stored in their respective
  1918. .FON files.
  1919.  
  1920. BAUD rate is also something that will normally be attached to a FON record and
  1921. used when dialing the record.  This is of more concern to users of modems that
  1922. do not allow LOCKING the port.
  1923.  
  1924. LOCK BAUD is almost always available as an option when using a modem that can
  1925. support CONNECT rates above 2400 baud.  When using the LOCK BAUD option,
  1926. AceComm will leave the port speed alone when dialing.  The modem handles speed
  1927. translation between 'connect' and 'computer'.  LOCK BAUD ON is generally
  1928. preferable with modems that support it.  The status displays will reflect 'L'
  1929. appended to the baud rate when LOCK BAUD is set ON.  NOTE: the 'L' is not
  1930. appended in the Line Control Window's display above.
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.        Page 29              AceComm (tm) v 1.85
  1944.  
  1945.  
  1946. Chapter 4  PRM-data Menus Area
  1947.  
  1948.            UART Line Control
  1949.  
  1950.  
  1951.  
  1952.     ╔═══ Serial Port Setup Menu ═══════════╗
  1953.     ║ Port Number Select      1            ║
  1954.     ║╔═ UART Line Control ═══════════════╗ ║
  1955.     ║║╔═ Data Bits ═══════════════════════╗║
  1956.     ║║║>5                                 ║║
  1957.     ║║║ 6                                 ║║
  1958.     ║║║ 7                                 ║║
  1959.     ║║║ 8                                 ║║
  1960.     ╚╚╚═ Select  Quit ════════════════════╝╝
  1961.     ╔═══ Serial Port Setup Menu ═══════════╗
  1962.     ║ Port Number Select      1            ║
  1963.     ║╔═ UART Line Control ═══════════════╗ ║
  1964.     ║║ Data Bits          8              ║ ║
  1965.     ║║╔═ Parity ══════════════════════════╗║
  1966.     ║║║>None                              ║║
  1967.     ║║║ Odd                               ║║
  1968.     ║║║ Even                              ║║
  1969.     ╚╚║ Mark                              ║╝
  1970.       ║ Space                             ║
  1971.       ╚═ Select  Quit ════════════════════╝
  1972.     ╔═══ Serial Port Setup Menu ═══════════╗
  1973.     ║ Port Number Select      1            ║
  1974.     ║╔═ UART Line Control ═══════════════╗ ║
  1975.     ║║ Data Bits          8              ║ ║
  1976.     ║║ Parity             None           ║ ║
  1977.     ║║╔═ Stop Bits ═══════════════════════╗║
  1978.     ║║║>1                                 ║║
  1979.     ║║║ 2                                 ║║
  1980.     ╚╚╚═ Select  Quit ════════════════════╝╝
  1981.  
  1982. Data Format
  1983.  
  1984.   Stop bits, Parity, Data bits.  Each character that comes in the serial port
  1985.   arrives as a series of BITS.  The BITS are assembled in your serial port's
  1986.   UART's SERIAL DATA UNIT SDU).
  1987.  
  1988.   AceComm's default setting of 8 data bits, no parity, and 1 stop bit is the
  1989.   most popular arrangement, and that which most BBS systems use.  You will
  1990.   change the Data Format when necessary for connecting with systems that don't
  1991.   use the standard 8N1.
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.        Page 30              AceComm (tm) v 1.85
  2003.  
  2004.  
  2005. Chapter 4  PRM-data Menus Area
  2006.  
  2007.            UART Line Control (continued)
  2008.  
  2009.  
  2010. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2011. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2012. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2013. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  2014. ░░░░░░░░░░░░░░░░░░░░░│ Area controls / Options menus        │░░░░░░░░░░░░░░░░░
  2015. ░░░░░░░░░░░░░░░░░░░░░│┌───Serial Port/Modem Setup────────────┐░░░░░░░░░░░░░░░░
  2016. ░░░░░░░░░░░░░░░░░░░░░││ Port Number Select      2            │░░░░░░░░░░░░░░░░
  2017. ░░░░░░░░░░░░░░░░░░░░░││┌─UART Line Control─────────────────┐ │░░░░░░░░░░░░░░░░
  2018. ░░░░░░░░░░░░░░░░░░░░░│││ Data Bits          8              │ │░░░░░░░░░░░░░░░░
  2019. ░░░░░░░░░░░░░░░░░░░░░│││ Parity             None           │ │░░░░░░░░░░░░░░░░
  2020. ░░░░░░░░░░░░░░░░░░░░░│││┌─Baud Select───────────┐          │ │░░░░░░░░░░░░░░░░
  2021. ░░░░░░░░░░░░░░░░░░░░░│└││>300                   │          │─┘░░░░░░░░░░░░░░░░
  2022. ░░░░░░░░░░░░░░░░░░░░░│ ││ 1200                  │          ││░░░░░░░░░░░░░░░░░
  2023. ░░░░░░░░░░░░░░░░░░░░░│ └│ 2400                  │^├────────┘│░░░░░░░░░░░░░░░░░
  2024. ░░░░░░░░░░░░░░░░░░░░░│ A│ 4800                  │           │░░░░░░░░░░░░░░░░░
  2025. ░░░░░░░░░░░░░░░░░░░░░│ E│ 9600                  │           │░░░░░░░░░░░░░░░░░
  2026. ░░░░░░░░░░░░░░░░░░░░░│ A│ 19200                 │           │░░░░░░░░░░░░░░░░░
  2027. ░░░░░░░░░░░░░░░░░░░░░└──│ 38400                 │^├─────────┘░░░░░░░░░░░░░░░░░
  2028. ░░░░░░░░░░░░░░░░░░░░░░░░│ 57600                 │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2029. ░░░░░░░░░░░░░░░░░░░░░░░░│ 115200                │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2030. ░░░░░░░░░░░░░░░░░░░░░░░░└─ Select  Quit  Help ──┘░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2031. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2032.  
  2033.  
  2034. o Connect speeds such as 12000, 14400 etc.  are not actual data rates that the
  2035.   UART (serial port) can be set to.
  2036.  
  2037. o Modems capable of connecting at 9600 and above can usually be used with a
  2038.   "Locked port"
  2039.  
  2040. o Setting the Baud rate to 19200 for a 9600 baud modem will allow better
  2041.   performance when down loading data.
  2042.  
  2043. o Locking the port means selecting a baud rate higher than the highest connect
  2044.   speed the modem is capable of, and telling the communications software to
  2045.   lock it there.
  2046.  
  2047. o Using a locked port requires your modem be in full handshake mode.
  2048.  
  2049.  
  2050.    "14.4k, 16.8k modems"
  2051.  
  2052.   Q.) Why doesn't AceComm support my 14.4k modems connect speed of 14400 in
  2053.       the "Baud Select" menu?
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.        Page 31              AceComm (tm) v 1.85
  2062.  
  2063.  
  2064. Chapter 4  PRM-data Menus Area
  2065.  
  2066.            UART Line Control (continued)
  2067.  
  2068.   A.) 14400 is a data rate your modem is capable of.  The serial port in your
  2069.       computer cannot be set to 14400 baud.  In order to operate at 14400
  2070.       connect speeds, the serial port must be set to 19200, 38400, or 57600
  2071.       baud.
  2072.  
  2073.       o 14400 is your modems "Connection Rate" "Line Speed", "Modem-to-Modem
  2074.          Speed", "DCE Speed" are other synonyms for "Connection Rate"
  2075.  
  2076.       o 19200 is the closest "Computer Rate"
  2077.  
  2078.       o Selecting the closest "Computer Rate" is called using a "Locked" port
  2079.  
  2080.         When using a "Locked" port your modem makes the translation between
  2081.         "Connection Rate" and "Computer Rate" by using FLOW control (RTS/CTS
  2082.         hardware handshaking) Your serial port can be set to 19200, or 38400
  2083.         and left there (See LOCKBAUD)
  2084.  
  2085.  
  2086.  
  2087. "Selecting your highest port speed when LOCKing the port"
  2088.  
  2089.   Locking the port at 57600 with a high speed modem causes the UART to assemble
  2090.   a character off the bit stream VERY quickly.
  2091.  
  2092.   If you experience serial input errors with HIGH locked rates, drop down to
  2093.   38400 or even 19200.  The lower rate will cause the UART to make characters
  2094.   available at a reduced speed.  For instance a 12 MHZ AT will probably
  2095.   experience data overruns using a locked port above 19200 when down loading
  2096.   TEXT files with ZMODEM.
  2097.  
  2098.   A common miss-conception is when CRC errors occur with HIGH LOCKED PORT
  2099.   rates, that it is the UART unable to keep up.  This is simply not true.  The
  2100.   UART/modem combo is capable of out running the computer/software combo.  When
  2101.   using a TASK switcher such as WINDOWS or DESQVIEW, a lower PORT RATE such as
  2102.   19200 may very well be needed for efficient data transfers.
  2103.  
  2104.   The idea is to set the port to a speed that the computer/software combo is
  2105.   capable of responding to quickly enough.
  2106.  
  2107.  
  2108.  
  2109. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2110. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2111. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2112. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  2113. ░░░░░░░░░░░░░░░░░░░░░│ Area controls / Options menus        │░░░░░░░░░░░░░░░░░
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.        Page 32              AceComm (tm) v 1.85
  2121.  
  2122.  
  2123. Chapter 4  PRM-data Menus Area
  2124.  
  2125.            Modem Response Strings
  2126.  
  2127. ░░░░░░░░░░░░░░░░░░░░░│┌───Serial Port/Modem Setup────────────┐░░░░░░░░░░░░░░░░
  2128. ░░░░░░░░░░░░░░░░░░░░░││ Port Number Select      2            │░░░░░░░░░░░░░░░░
  2129. ░░░░░░░░░░░░░░░░░░░░░││┌─Modem Response Strings──────────────┐░░░░░░░░░░░░░░░░
  2130. ░░░░░░░░░░░░░░░░░░░░░│││ OK              OK^M                │░░░░░░░░░░░░░░░░
  2131. ░░░░░░░░░░░░░░░░░░░░░│││ RING            RING^M              │░░░░░░░░░░░░░░░░
  2132. ░░░░░░░░░░░░░░░░░░░░░│││ NO_CARRIER      NO CARRIER          │░░░░░░░░░░░░░░░░
  2133. ░░░░░░░░░░░░░░░░░░░░░│└│ ERROR           ERROR               │░░░░░░░░░░░░░░░░
  2134. ░░░░░░░░░░░░░░░░░░░░░│ │ NO_DIAL_TONE    NO DIAL TONE        │░░░░░░░░░░░░░░░░
  2135. ░░░░░░░░░░░░░░░░░░░░░│ │ BUSY            BUSY                │░░░░░░░░░░░░░░░░
  2136. ░░░░░░░░░░░░░░░░░░░░░│ │ NO_ANSWER       NO ANSWER           │░░░░░░░░░░░░░░░░
  2137. ░░░░░░░░░░░░░░░░░░░░░│ │ RINGING         RINGING^M           │░░░░░░░░░░░░░░░░
  2138. ░░░░░░░░░░░░░░░░░░░░░│ │ VOICE           VOICE               │░░░░░░░░░░░░░░░░
  2139. ░░░░░░░░░░░░░░░░░░░░░└─│ Connect 1       CONNECT             │░░░░░░░░░░░░░░░░
  2140. ░░░░░░░░░░░░░░░░░░░░░░░│>Connect 2       CARRIER             │░░░░░░░░░░░░░░░░
  2141. ░░░░░░░░░░░░░░░░░░░░░░░│ Connect 3       FAX                 │░░░░░░░░░░░░░░░░
  2142. ░░░░░░░░░░░░░░░░░░░░░░░└─ Edit  Quit  Help ┤<>v^├────────────┘░░░░░░░░░░░░░░░░
  2143. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2144.  
  2145.  
  2146. o AceComm uses text response strings only
  2147.  
  2148. o Connect strings will allow non-locked ports "auto adjust" AceComm leaves
  2149.    locked ports set to the selected LOCKBAUD rate.
  2150.  
  2151. Modem response strings are normally UPPER CASE.  Response strings are used by
  2152. AceComm when dialing to more quickly respond to BUSY, NO CARRIER etc.  HOSTMODE
  2153. will be waiting for a RING code.(1) The Response strings that can be matched
  2154. while dialing are displayed in the DIAL WINDOW as they come in.
  2155.  
  2156. AceComm will detect a connection after dialing, a few seconds quicker when able
  2157. to match a connect string with the modem's connect message.
  2158.  
  2159. High Speed modem users may configure the modem for more than 1 connect message
  2160. to be returned from the modem.  AceComm need only detect 1.  The connect string
  2161. fields are freely configurational, and follow no specific order.  Leave them,
  2162. or edit them as needed any way you see fit.
  2163.  
  2164. AceComm will fall out of re-dial on detection of carrier anyway.  For the LOCK
  2165. BAUD users, this detection is right away.  For those who use modems that don't
  2166. allow port LOCKING, and want auto baud rate adjustment to match the connect,
  2167. carrier is checked only after the dialing has timed out.  AceComm will be
  2168. trying it's best to get a CONNECT string so that the connect speed can be
  2169. checked.
  2170.  
  2171.  
  2172. (1) HOSTMODE also uses the UART's modem status register RI bit when detecting
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.        Page 33              AceComm (tm) v 1.85
  2180.  
  2181.  
  2182. Chapter 4  PRM-data Menus Area
  2183.  
  2184.            Modem Response Strings (continued)
  2185.  
  2186.      "RING".
  2187.  
  2188.  
  2189.  
  2190. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2191. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2192. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2193. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  2194. ░░░░░░░░░░░░░░░░░░░░░│ Area controls / Options menus        │░░░░░░░░░░░░░░░░░
  2195. ░░░░░░░░░░░░░░░░░░░░░│┌───Serial Port/Modem Setup────────────┐░░░░░░░░░░░░░░░░
  2196. ░░░░░░░░░░░░░░░░░░░░░││ Port Number Select      2            │░░░░░░░░░░░░░░░░
  2197. ░┌───Modem Command Strings────────────────────────────────────┐░░░░░░░░░░░░░░░
  2198. ░│>Setup              ATH0^M~AT&F2^M~ATE0&W0                  │░░░░░░░░░░░░░░░
  2199. ░│ Init               ATZ^M~ATE0&C1&D2                        │░░░░░░░░░░░░░░░
  2200. ░│ Dial Prefix        ATEQ0X4DT                               │░░░░░░░░░░░░░░░
  2201. ░│ Dial Suffix                                                │░░░░░░░░░░░░░░░
  2202. ░│ Answer             ATA                                     │░░░░░░░░░░░░░░░
  2203. ░│ Hangup             +++~ATH0                                │░░░░░░░░░░░░░░░
  2204. ░│ Offhook            ATH1                                    │░░░░░░░░░░░░░░░
  2205. ░│ Abort              ^M                                      │░░░░░░░░░░░░░░░
  2206. ░│ Reset              ATZ                                     │░░░░░░░░░░░░░░░
  2207. ░│ Command Echo       ATE1                                    │░░░░░░░░░░░░░░░
  2208. ░│ Host Init          ATE                                     │░░░░░░░░░░░░░░░
  2209. ░│ Cmd Enter          ^M                                      │░░░░░░░░░░░░░░░
  2210. ░└─── Edit  Select  Quit  Help ┤<>v^├─────────────────────────┘░░░░░░░░░░░░░░░
  2211. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2212.  
  2213.  
  2214. o Cmd Terminator is automatically appended to modem command strings.
  2215.  
  2216. Here we have the modem commands AceComm uses to interact with your modem.
  2217. Please note the bottom of the menu contains the "Cmd Terminator".  AceComm
  2218. appends this to all modem commands automatically.  Notice that "Init" has a ^M
  2219. followed by ~ and another command.  This is an example of command stacking.
  2220.  
  2221. '^' is an escape character AceComm recognizes and translates byte following
  2222. into control characters.  ^M translates into a carriage return, <CR>, (13d).  A
  2223. character following '^' is either upper case or made upper case by AceComm,
  2224. then subtracted by 64 converting 'A' to 1 etc.
  2225.  
  2226. '~' translate into 1 second delays.
  2227.  
  2228. '`' translate into 5 second delays.
  2229.  
  2230. AceComm modem command lines are limited to 40 characters in length, including
  2231. the Cmd Terminator.  This is a standard maximum command length used by modem
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.        Page 34              AceComm (tm) v 1.85
  2239.  
  2240.  
  2241. Chapter 4  PRM-data Menus Area
  2242.  
  2243.            Modem Commands
  2244.  
  2245. manufacturers.
  2246.  
  2247.  
  2248.  
  2249.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2250.    ║ General Controls                       ║
  2251.    ║╔═══ Serial Port Setup Menu ═══════════╗║
  2252.    ║║ Port Number Select      1            ║║
  2253.    ║║ Line Control Setup      19200L,8N1   ║║
  2254.    ║║ Modem Connect Strings                ║║
  2255.    ║║ Modem Response Strings               ║║
  2256.    ║║ Modem Command Strings                ║║
  2257.    ║║╔═ Modem Control════════════════════╗ ║║
  2258.    ║║║>DTR      On                       ║ ║║
  2259.    ╚╚║ RTS      On                       ║═╝╝
  2260.      ║ GPO1     Off                      ║
  2261.      ║ GPO2     On                       ║
  2262.      ║ Loopback Off                      ║
  2263.      ║═Modem Status══════════════════════║
  2264.      ║ CTS      On                       ║
  2265.      ║ DSR      On                       ║
  2266.      ║ RI       Off                      ║
  2267.      ║ DCD      Off                      ║
  2268.      ╚═ Select  Quit ════════════════════╝
  2269.  
  2270. Modem Control
  2271.  
  2272. o GPO2 must be set "ON" for interrupt to seen by the computer
  2273.  
  2274. o Normal operation requires LOOPBACK be left "OFF"
  2275.  
  2276. These controls are available for experienced users.  The "Modem Control" menu
  2277. will allow setting or re-setting each of the bits listed.  If you want
  2278. interrupts to continue to be recognized you shall make sure and leave GPO2
  2279. "ON".  GPO2 "OFF" will disable interrupts for the port, and AceComm will not
  2280. function properly.  Same with Loop back.  If in doubt, you can use the above
  2281. snapshot as a reference to correct bit setting of the modem control register.
  2282.  
  2283.  
  2284. Modem Status
  2285.  
  2286. o DSR will normally be SET when a modem is powered up.  AceComm will alert the
  2287.    user on DSR not SET when installing on a port.
  2288.  
  2289.  
  2290.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.        Page 35              AceComm (tm) v 1.85
  2298.  
  2299.  
  2300. Chapter 4  PRM-data Menus Area
  2301.  
  2302.            Default Video Emulation
  2303.  
  2304.    ║ General Controls                       ║
  2305.    ║╔═══ Serial Port Setup Menu ═══════════╗║
  2306.    ║║ Port Number Select      1            ║║
  2307.    ║║ Line Control Setup      19200L,8N1   ║║
  2308.    ║║ Modem Connect Strings                ║║
  2309.    ║║ Modem Response Strings               ║║
  2310.    ║║ Modem Command Strings                ║║
  2311.    ║║ Modem Control Setup                  ║║
  2312.    ║║╔═Default Video Emulation════════════════════════════╗
  2313.    ╚╚║═Video Emulation  <>  Associated KTS file═══════════║
  2314.      ║ TTY                   TTY.KTS                      ║
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.        Page 36              AceComm (tm) v 1.85
  2357.  
  2358.      ║ Ansi                  ANSI.KTS                     ║
  2359.      ║>Avatar                AVATAR.KTS                   ║
  2360.      ║ VT102                 VT102.KTS                    ║
  2361.      ╚═ New_Vid  Asso_KTS  Quit  View_Cur_KTS ════════════╝
  2362.  
  2363. o Video Terminal emulation is built into AceComm
  2364.  
  2365. o Associated KTS file is the Keyboard Translation Sequence file that will be
  2366.   loaded for the given Video Type.
  2367.  
  2368. o Keyboard Terminal emulation is defined inside of *.KTS files AceComm includes
  2369.   a separate utility KTS.EXE which allows the user to define KTS files for any
  2370.   Keyboard Terminal emulation desired.
  2371.  
  2372. AceComm emulates the selected VIDEO type.  "Associated KTS file" is the .KTS
  2373. file you want to use with the VIDEO selection.  Each time AceComm activates a
  2374. VIDEO type, the associated KTS file is loaded and becomes active on the
  2375. keyboard.  KTS keyboard definitions override MACRO assignments.
  2376.  
  2377. KTS (Key Translation Sequence) files contain assignments for a sequence of
  2378. characters to a key press.  When a key is pressed from inside TERMINAL area,
  2379. AceComm first checks to see if the key press has been defined in the current
  2380. KTS data.  If so, AceComm sends the assigned sequence of characters to the
  2381. modem.  The utility KTS.EXE (included) can be used to create new and or custom
  2382. KTS files.  See the included .ASC examples for defining and creating KTS
  2383. files.  Using KTS.EXE, the keyboard can be deigned to emulate any possible
  2384. combination of characters available to the system.  Key press assignments
  2385. defined in the KTS data area are given top priority, and thus take presides
  2386. over MACROS assigned to the same key.
  2387.  
  2388.  
  2389.  
  2390.  
  2391. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2392. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░┌─VT102.KTS─────────────────────────┐
  2393. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│>TAB          ^I                   │
  2394. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ Del/.                            │
  2395. ░░░░░░░░░░░░░░░░░░░░░┌───────────────────│ Home/7       ^[[H                 │
  2396. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Me│ Up/8         ^[[A                 │
  2397. ░░░░░░░░░░░░░░░░░░░░░│┌─Area controls / O│ Left/4       ^[[D                 │
  2398. ░░░░░░░░░░░░░░░░░░░░░││ Telephone book on│ Right/6      ^[[C                 │
  2399. ░░░░░░░░░░░░░░░░░░░░░││ Allow enhanced ke│ End/1        ^[[K                 │
  2400. ░░░░░░░░░░░░░░░░░░░░░││ Allow mouse detec│ Down/2       ^[[B                 │
  2401. ░░░░░░░░░░░░░░░░░░░░░││ Mouse horizontal │ Keypad-0     ^[Op                 │
  2402. ░░░░░░░░░░░░░░░░░░░░░││ Mouse vertical se│ Keypad-1     ^[Oq                 │
  2403. ░░░░░░░░░░░░░░░░░░░░░││ Auto Save Changes│ Keypad-2     ^[Or                 │
  2404. ░░░░░░░░░░░░░░░░░░░░░││ Screen Saver time│ Keypad-3     ^[Os                 │
  2405. ░░░░░░░░░░░░░░░░░░░░░││┌─Terminal Area Op│ Keypad-4     ^[Ot                 │
  2406. ░░░░░░░░░░░░░░░░░░░░░│││┌─Default Video E│ Keypad-5     ^[Ou                 │
  2407. ░░░░░░░░░░░░░░░░░░░░░││││─Video Emulation│ Keypad-6     ^[Ov                 │
  2408. ░░░░░░░░░░░░░░░░░░░░░││││ TTY            │ Keypad-7     ^[Ow                 │
  2409. ░░░░░░░░░░░░░░░░░░░░░││││ Ansi           │ Keypad-8     ^[Ox                 │
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.        Page 37              AceComm (tm) v 1.85
  2417.  
  2418.  
  2419. Chapter 4  PRM-data Menus Area
  2420.  
  2421.            Key Translation Sequence file (.KTS)
  2422.  
  2423. ░░░░░░░░░░░░░░░░░░░░░└│││ Avatar         │ Keypad-9     ^[Oy                 │
  2424. ░░░░░░░░░░░░░░░░░░░░░░│││ Av/An          │ Keypad--     ^[Om                 │
  2425. ░░░░░░░░░░░░░░░░░░░░░░│││>VT102          │ Keypad-*     ^[Ol                 │
  2426. ░░░░░░░░░░░░░░░░░░░░░░└└└─ New_Vid  Asso_└─ Select  More  Quit  Help ┤<>v^├──┘
  2427. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2428.  
  2429. KTS files contain a sequence of bytes to be sent to the modem when a particular
  2430. key press is made.  AceComm emulates a video type independently from the
  2431. keyboard emulation.  KTS files may be edited to emulate any combination
  2432. imaginable.  KTS files may be created and assigned to a video type using the
  2433. "Associate" option above.
  2434.  
  2435. AceComm comes with ready made KTS files.
  2436.  
  2437.    Notes: .KTS files are compiled from .ASC files.  .ASC files may be created,
  2438.           maintained, customized with a TEXT EDITOR in ASCII TEXT mode.  The
  2439.           utility KTS.EXE is provided for compiling .ASC files into .BIN
  2440.           files.  Rename the .BIN file with .KTS and copy the .KTS file into
  2441.           the directory pointed to in PRM-data for ".KTS".
  2442.  
  2443.  
  2444.  
  2445.     ╓─KeyBoard Redefinition────────╖
  2446.     ║─Current Keyboard:ACE_DEF.KBD─║
  2447.     ║>      F1 - F12               ║
  2448.     ║   ALT-F1 - F12               ║
  2449.     ║  CTRL-F1 - F12               ║
  2450.     ║ SHIFT-F1 - F12               ║
  2451.     ║  ALT+KEY Combo               ║
  2452.     ║ CTRL+KEY Combo               ║
  2453.     ║  Extended Keys               ║
  2454.     ╙─── Select  Write  Quit───────╜
  2455. o Each of the above key sets is available for assignment to a MACRO or MACRO
  2456.   stack.  The MACROS provide a wide range of services.  All of AceComm's
  2457.   functionality is available with MACROS.
  2458.  
  2459. o The "SHIFT-Fn" key-set is used by TAGGER to store TAGGED ITEMS
  2460.  
  2461. Menu options here allow each key press be re-assigned.  The keyboard can be
  2462. arranged thru the use of MACROS to resemble software you are more accustomed
  2463. to.  AceComm`s keyboard is totally MACRO driven.  Keyboard definitions are
  2464. stored in .KBD files.  ACE.CTL can be edited so future upgrades of AceComm will
  2465. automatically configure with your keyboard preference.
  2466.  
  2467.  
  2468. Write
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.        Page 38              AceComm (tm) v 1.85
  2476.  
  2477.  
  2478. Chapter 4  PRM-data Menus Area
  2479.  
  2480.            Keyboard Redefinition
  2481.  
  2482.   Prompts for a filename, and writes the current keyboard to a new KBD file, or
  2483.   updates an existing KBD file of the same name.
  2484.  
  2485.   When you choose "Write" the following occurs:
  2486.  
  2487.     AceComm  prompts  for  "filename"
  2488.     "filename"  is  forced a ".KBD"  extension
  2489.     "filename" is written in the same directory as ACE.PRM
  2490.     resides
  2491.     AceComm writes the contents of "Key MACRO Assignments" menu
  2492.     to the file
  2493.     AceComm re-reads the original KBD file.
  2494.  
  2495.   In short:
  2496.   - All changes, once written to a KBD file with "Write", pertain to the KBD
  2497.     file written to.
  2498.   - Making changes and not "Writing" them, will be saved to the current KBD
  2499.     file at program end.
  2500.  
  2501. To further explain, all changes made in this menu area to the keyboard
  2502. definitions, apply to the current KBD file.  If you exit the menu area, without
  2503. choosing "Write", and say "ACE_DEF.KBD" is active, the changes will be stored
  2504. to "ACE_DEF.KBD" when you leave the PRM-data area.  If you choose "Write" from
  2505. the above menu, then the changes are stored to a new or existing KBD file, and
  2506. do not affect the current keyboard, as AceComm re-loads the current KBD file
  2507. after a "Write".  Unless you "Write" to the current KBD file, which is un
  2508. necessary, because AceComm will update it automatically anyway.
  2509.  
  2510. "SHIFT-Fn" is the key-set the TAGGER function assigns TAGGED ITEMS to.  When
  2511. you tag a word or line from the screen, the tagged item becomes associated with
  2512. the first available SHIFT-Fn key by way of the <SEND_SendStr> MACRO.
  2513.  
  2514. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2515. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2516. ┌─ F# Keys ───────────────────────────────────────────────────────────────────
  2517. │> 1<SendStr>[USER_NAME]^M
  2518. │  2<SendStr>[FON_REC_PWD]^M
  2519. │  3<SendStr>[LOCATION]^M
  2520. │  4<SendStr>[VOICE_PNUM]^M
  2521. │  5<SendStr>[PASSWORD]^M
  2522. │  6<SetDTR> ON
  2523. │  7<SendAscii> %PF
  2524. │  8<Users>
  2525. │  9<HelpMenu>
  2526. │ 10<TopBar>
  2527. │ 11<User>1
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.        Page 39              AceComm (tm) v 1.85
  2535.  
  2536.  
  2537. Chapter 4  PRM-data Menus Area
  2538.  
  2539.            Keyboard Redefinition (continued)
  2540.  
  2541. │ 12<SendStr>75120,3306^M
  2542. └─── Edit  Zap  Quit ┤<>v^├───────────────────────────────────────────────────
  2543. ░░░░░░░░░░░░░░░░░░░░░└─── Select  Quit  Help ┤<>v^├─────────┘░░░░░░░░░░░░░░░░░
  2544. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2545.  
  2546. Edit
  2547.  
  2548.   Allows editing the MACRO assignment.
  2549.  
  2550.  
  2551. Zap
  2552.  
  2553.   Clears field (Zaps) the MACRO assignment.
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.        Page 40              AceComm (tm) v 1.85
  2594.  
  2595.  
  2596. Chapter 4  PRM-data Menus Area
  2597.  
  2598.            Keyboard Redefinition (continued)
  2599.  
  2600.  
  2601.  
  2602.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2603.    ║ General Controls                       ║
  2604.    ║ Serial Port Setup                      ║
  2605.    ║╔═KeyBoard MACRO Assignments═══╗        ║
  2606. ╔═ SHIFT F# Keys ═══════════════════════════════════════════════
  2607. ║  1<SENDSTR>80XXX_92.ARJ
  2608. ║  2
  2609. ║  3
  2610. ║  4
  2611. ║> 5
  2612. ║  6
  2613. ║  7
  2614. ║  8
  2615. ║  9
  2616. ║ 10
  2617. ║ 11
  2618. ║ 12
  2619. ╚═══ Edit  Zap  Quit ═══════════════════════════════════════════
  2620.  
  2621. "SHIFT-Fn" key-set the TAGGER function assigns TAGGED ITEMS to.
  2622.  
  2623. When you tag a word or line from the screen, the tagged item becomes associated
  2624. with the first available SHIFT-Fn key by way of the <SEND_SendStr> MACRO.
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.        Page 41              AceComm (tm) v 1.85
  2653.  
  2654.  
  2655. Chapter 4  PRM-data Menus Area
  2656.  
  2657.            Keyboard Redefinition (continued)
  2658.  
  2659.  
  2660. ┌─ALT+KEY Combo───────────────────────────────────────────────────────────────
  2661. │>ALT-A <AutoScrGen_>
  2662. │ ALT-B <ScrollBack_>
  2663. │ ALT-C <CaptureFile_>
  2664. │ ALT-D <PhoneList_>
  2665. │ ALT-E <SendStr> ATE^M <HostEcho>
  2666. │ ALT-F <FileList_>[DIR_DNLDS]
  2667. │ ALT-G <FileReq_>
  2668. │ ALT-H <MdmHangUp_>
  2669. │ ALT-I
  2670. │ ALT-J <DOSShell_>
  2671. │ ALT-K
  2672. │ ALT-L <RunProg> list
  2673. │ ALT-M <SendStr>ath1^M <ChgDir>mail\ged <RunProg>GOLDED <ChgDir>[DIR_START]
  2674. │ ALT-N <ChgDir>c:\mail\qm <RunProg>QM toss <ChgDir>[DIR_START]
  2675. │ ALT-O <PrmData_>
  2676. │ ALT-P <PrmData_>
  2677. │ ALT-Q
  2678. │ ALT-R <RunScript_>
  2679. │ ALT-S <ScrnDump_>
  2680. │ ALT-T <ScrnTag_>
  2681. └─── Edit  More  Quit ┤<>v^├──────────────────────────────────────────────────
  2682.  
  2683. PgDn/PgUp toggles display between above and below
  2684.  
  2685.  
  2686.  
  2687.     ╓─Directories in Use Menu─────────────────────────────────
  2688.     ║>.FON files: D:\ACE
  2689.     ║ .CAP files: D:\ACE
  2690.     ║ .SCR files: D:\ACE
  2691.     ║ .KTS files: D:\ACE
  2692.     ║  Downloads: D:\ACE
  2693.     ║   Nodelist: D:\ACE
  2694.     ║  .REQ/.FLO: D:\AC
  2695.     ╙─── Edit  Quit ──────────────────────────────────────────
  2696.  
  2697. .FON
  2698.  
  2699.   Where AceComm expects .FON files to be.
  2700.  
  2701.  
  2702. .CAP
  2703.  
  2704.   Where AceComm will create and or re-open CAPTURE files.  A CAPTURE file is a
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.        Page 42              AceComm (tm) v 1.85
  2712.  
  2713.  
  2714. Chapter 4  PRM-data Menus Area
  2715.  
  2716.            Directories in Use Menu
  2717.  
  2718.   means for "capturing" all port I/O to DISK.  When you open a capture file,
  2719.   AceComm records everything that comes into the serial port, exactly as it
  2720.   comes in.  Capture mode can be set to "Text" or "Raw".  "Raw" mode, no
  2721.   filtering, no translation of any kind takes place.(1) Video codes are
  2722.   recorded as they come in.  This allows capture of ANSI, AVATAR, RIP etc.
  2723.   screens.  "Text" mode, video control codes are filtered from the captured
  2724.   text.  AceComm does not overwrite CAPTURE files.  You have the option of
  2725.   renaming the file, or AceComm will append new data to the end of the
  2726.   file(2).  Time/Date stamps are always placed at the beginning of a capture
  2727.   file when opened.
  2728.  
  2729.  
  2730. .SCR
  2731.  
  2732.   Where AceComm will create and or look for .SCR files.  The MACRO <RunScript_>
  2733.   lists this directory.
  2734.  
  2735.  
  2736. .KTS
  2737.   Where AceComm expects to find it's KTS files.  It's ok to store
  2738.   your .ASC files in this directory.
  2739.  
  2740. Downloads
  2741.  
  2742.   This is the directory that AceComm 's internal protocols will receive into.
  2743.   AceComm will also list this directory when building upload LISTFILES.
  2744.  
  2745.  
  2746. Nodelist
  2747.  
  2748.   When you select the FileRequest option, AceComm expects to find either (a) a
  2749.   valid RAW FIDO NODELIST and NLIST.IDX file(3).  or "Boss Data".
  2750.  
  2751.  
  2752. .REQ/.FLO
  2753.  
  2754.   .REQ files are used when doing File Requests.  When you ask AceComm to make a
  2755.   File Request, the filename is created using the NET/NODE number in ascii hex,
  2756.   and the file extensions is ".REQ".
  2757.  
  2758.   .FLO files (Mail List File) are used when you want to Fil Attach to a
  2759.   NET/NODE.  File Attach may be any file(s), and will
  2760.   for point mail operators to send their mail bundle to the HOST.
  2761.  
  2762. (1) ANSI.EXE is a provided utility that can filter VIDEO CONTROL SEQUENCES from
  2763.      DISK files.
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.        Page 43              AceComm (tm) v 1.85
  2771.  
  2772.  
  2773. Chapter 4  PRM-data Menus Area
  2774.  
  2775.            Directories in Use Menu (continued)
  2776.  
  2777.  
  2778. (2) If you have edited a CAPTURE file, or by other means used any utility that
  2779.      added the 26d character to the file, AceComm will not overwrite the END OF
  2780.      FILE character.  This may result in some editors not recognizing new data
  2781.      that follows the 26d character.  There exists utilities that can filter
  2782.      this and other characters from TEXT files.
  2783.  
  2784. (3) NLIST.IDX is a file created using the AceComm utility IDX.EXE.  IDX.EXE
  2785.      will create a small index into the RAW FIDO NODELIST file, for all
  2786.      ZONE:NET pairs.
  2787.  
  2788.  
  2789.  
  2790.  
  2791. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2792. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2793. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  2794. ░░░░░░░░░░░░░░░░░░░░░│ Area controls / Options menus        │░░░░░░░░░░░░░░░░░
  2795. ░░░░░░░░░░░░░░░░░░░░░│ Serial Port/Modem Setup              │░░░░░░░░░░░░░░░░░
  2796. ░░░░░░░░░░░░░░░░░░░░░│ KeyBoarD Macro Assignments           │░░░░░░░░░░░░░░░░░
  2797. ░░░░░░░░░░░░░░░░░░░░░│┌─External Programs Setup──────┐      │░░░░░░░░░░░░░░░░░
  2798. ░░░░░░░░░░░░░░░░░░░░░││>*.ARJ                        │      │░░░░░░░░░░░░░░░░░
  2799. ░░░░░░░░░░░░░░░░░░░░░││ *.ARC                        │      │░░░░░░░░░░░░░░░░░
  2800. ░░░░░░░░░░░░░░░░░░░░░││ *.LZH                        │logy" │░░░░░░░░░░░░░░░░░
  2801. ░░░░░░░░░░░░░░░░░░░░░││ *.SDN                        │      │░░░░░░░░░░░░░░░░░
  2802. ░░░░░░░░░░░░░░░░░░░░░││ *.ZIP                        │      │░░░░░░░░░░░░░░░░░
  2803. ░░░░░░░░░░░░░░░░░░░░░││ *.ZOO                        │      │░░░░░░░░░░░░░░░░░
  2804. ░░░░░░░░░░░░░░░░░░░░░││ *.EXE                        │      │░░░░░░░░░░░░░░░░░
  2805. ░░░░░░░░░░░░░░░░░░░░░││ *.COM                        │      │░░░░░░░░░░░░░░░░░
  2806. ░░░░░░░░░░░░░░░░░░░░░││ *.DOC                        │      │░░░░░░░░░░░░░░░░░
  2807. ░░░░░░░░░░░░░░░░░░░░░└│ All others                   │──────┘░░░░░░░░░░░░░░░░░
  2808. ░░░░░░░░░░░░░░░░░░░░░░│ External Upload Protocols    │░░░░░░░░░░░░░░░░░░░░░░░░
  2809. ░░░░░░░░░░░░░░░░░░░░░░│ External Download Protocols  │░░░░░░░░░░░░░░░░░░░░░░░░
  2810. ░░░░░░░░░░░░░░░░░░░░░░└─── Select  Quit ┤<>v^ ───────┘░░░░░░░░░░░░░░░░░░░░░░░░
  2811. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2812.  
  2813. The extensions are used with the following menus, and are called when a
  2814. filename has been selected that contains the .EXT as listed.  Selections are
  2815. made while in <FileLister_> menu area.
  2816.  
  2817. Executable files are then handed over to AceComm's SPAWN function.
  2818. (<RunProg> equivalent) SPAWN can find files along the DOS PATH.  SPAWN can
  2819. also determine a files extension (.COM,
  2820. .EXE) SPAWN will use XMS,EMS,DISK swapping if the option is selected.  SWAP for
  2821. SPWAN is selected from inside PRM-data "General Controls" menu.
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.        Page 44              AceComm (tm) v 1.85
  2830.  
  2831.  
  2832. Chapter 4  PRM-data Menus Area
  2833.  
  2834.            External Programs Setup
  2835.  
  2836.  
  2837.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2838.    ║ General Controls                       ║
  2839.    ║ Serial Port Setup                      ║
  2840.    ║ KeyBoard Text Macros                   ║
  2841.    ║ Directories in use                     ║
  2842.    ║╔═ Executable files Menus ═════╗        ║
  2843.    ║║╔═%Fn = *.ARJ══════════════════════════════════════════════
  2844.    ║║║><RunProg> ARJ a -s %FN %WK
  2845.    ║║║ <RunProg> ARJ x %FN %WK
  2846.    ║║║ <RunProg> ARJ v %FN %WK
  2847.    ╚║║
  2848.     ║║
  2849.     ║╚═ Select  Edit  Quit ═════════════════════════════════════
  2850.     ║ *.COM                        ║
  2851.     ║ *.DOC                        ║
  2852.     ║ All others                   ║
  2853.     ║ External Upload Protocols    ║
  2854.     ║ External Download Protocols  ║
  2855.     ╚═══ Select  Quit ═════════════╝
  2856.  
  2857. Sample menu when a "Highlighted" file's extension of ".ARJ".  AceComm changes
  2858. to the directory being listed, so that any WORK done by the utility is done in
  2859. the LISTED directory.  AceComm will use the SWAP functions if allowed.  (see
  2860. SWAP enable flags located inside "General Controls" Menu Area.
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.        Page 45              AceComm (tm) v 1.85
  2889.  
  2890.  
  2891. Chapter 4  PRM-data Menus Area
  2892.  
  2893.            External Programs Setup (continued)
  2894.  
  2895.  
  2896.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2897.    ║ General Controls                       ║
  2898.    ║ Serial Port Setup                      ║
  2899.    ║ KeyBoard Text Macros                   ║
  2900.    ║ Directories in use                     ║
  2901.    ║╔═ Executable files Menus ═════╗        ║
  2902.    ║║ *.ARJ                        ║        ║
  2903.    ║║ *.ARC                        ║        ║
  2904.    ║║ *.LZH                        ║        ║
  2905.    ║║ *.SDN                        ║        ║
  2906.    ╚║ *.ZIP                        ║════════╝
  2907.     ║ *.ZOO                        ║
  2908.     ║╔═%FN = *.EXE══════════════════════════════════════════════
  2909.     ║║><RunProg> %FN %WK
  2910.     ║║ <RunProg> LIST %FN
  2911.     ║║
  2912.     ║║
  2913.     ║║
  2914.     ╚╚═ Select  Edit  Quit ═════════════════════════════════════
  2915.  
  2916. Sample menu for executable files.  Notice that the <RunProg> MACRO will be
  2917. handed the current "Highlighted" filename with the %FN MACRO.  In the above
  2918. example the %WK argument will cause AceComm to wait for a key press afterward.
  2919. This allows the user to view any finishing screens generated from the
  2920. executable file argument to <RunProg>.
  2921.  
  2922. This type of MACRO programming allows the user to fire up that QWK Mail Reader
  2923. (and what have you) on the fly without exiting AceComm.
  2924.  
  2925.  
  2926.  
  2927. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2928. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2929. ┌─Auto Engage Sequence Triggers───────────────────────────────────────────────
  2930. │─Trigger Sequence -- Responding Macro Stack──────────────────────────────────
  2931. │>rz^M**^X            <RecvZmo>
  2932. │ HS*^B               <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  2933. │ ^H ^H ^H ^H ^H ^H   <RunProg>BIMODEM \L%P \R[DIR_DNLDS] Bimodem.Pth
  2934. │ MPt ^V^H            <RunProg>MPT P%P N+ F+ R+ R [DIR_DNLDS]
  2935. │
  2936. │
  2937. │
  2938. │
  2939. │ **EMSI_REQA77E      <SendEMSI_CLI>
  2940. │ **EMSI_IRQ8E08      <SendEMSI_ICI>
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.        Page 46              AceComm (tm) v 1.85
  2948.  
  2949.  
  2950. Chapter 4  PRM-data Menus Area
  2951.  
  2952.            Auto Engage Protocols
  2953.  
  2954. │─Pre/Post AutoM Macros───────────────────────────────────────────────────────
  2955. │
  2956. │
  2957. └─── Edit  Quit  Help ┤<>v^├──────────────────────────────────────────────────
  2958. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2959.  
  2960. o The last byte in a Sequence Trigger is the sequence scan trigger byte
  2961.  
  2962. o The last byte in a Sequence Trigger should end in an un common character (as
  2963.   designed above)
  2964.  
  2965. o EMSI_REQ detection can allow swift access to a BBS when mailer software
  2966.   answers the phone
  2967.  
  2968. o EMSI_IRQ is sent by BBS software to tell the caller it can do Interactive
  2969.   EMSI data handshaking
  2970.  
  2971.   The above defaults have been working very well for the protocols associated.
  2972.  
  2973.  
  2974. Sequence Trigger
  2975.  
  2976.   A sequence trigger is a character string that is used by a remote HOST,
  2977.   protocol etc.  as an attempt to engage some action from the other end.
  2978.  
  2979.  
  2980. Trigger Character
  2981.  
  2982.   AceComm scans back thru it's receive buffer for a trigger sequence with each
  2983.   occurrence of the "last byte of the sequence".  This means that AceComm will
  2984.   scan for the string each time it sees the trigger byte arrive from the
  2985.   modem.  For this reason a sequence trigger will end in a non-common byte.
  2986.   While 'rz^M' (^M being <CR>, 13 decimal) would be a valid sequence trigger,
  2987.   we don't want AceComm to search on every carriage return character that comes
  2988.   in.  Look at Bimodem's sequence trigger, we don't want to end the sequence
  2989.   with a <SP> character (^' is the control code for SPACE CHARACTER 32
  2990.   decimal).
  2991.  
  2992.   Characters 32(Space) and below need be escape encoded with the '^' ^A becomes
  2993.   1, ^B 2, ^C 3, ^M <CR>, ^` 32 <SP> etc.  When entering sequence text, you may
  2994.   simply type the <SP> character, AceComm will do the conversion for you.
  2995.  
  2996.  
  2997. **EMSI_REQA77E
  2998.  
  2999.   Most FIDONET mailer software will send an EMSI_REQ string to a caller.  This
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.        Page 47              AceComm (tm) v 1.85
  3007.  
  3008.  
  3009. Chapter 4  PRM-data Menus Area
  3010.  
  3011.            Auto Engage Protocols (continued)
  3012.  
  3013.   string is an attempt to determine the caller type.  AceComm's <SendEMSI_CLI>
  3014.   MACRO tells the mailer this is a human caller, bypassing the common "Press
  3015.   ESC to enter BBS" prompt.  DBridge mailer software is in complete and won't
  3016.   recognize this advanced EMSI handshaking.  All other mailer software does.
  3017.  
  3018.  
  3019. **EMSI_IRQ8E08
  3020.  
  3021.   IEMSI capable BBS systems will send an EMSI_IRQ string to a caller.
  3022.   Detection of EMSI_IRQ is responded to with IEMSI data handshaking.
  3023.   AceComm's <SendEMSI_ICI> MACRO handles IEMSI log on.  (see PRM-data IEMSI
  3024.   Setup menu)
  3025.  
  3026.  
  3027. Responding MACRO Stack
  3028.  
  3029.   The MACRO defined to the right of each sequence trigger will be used when a
  3030.   sequence has been detected.  This allows AceComm to be configured with auto
  3031.   download detection for up to 10 protocols.  MACRO STACKING is valid with
  3032.   AutoM MACROS.
  3033.  
  3034.   The sending of a carriage return as the last macro is use full for moving the
  3035.   BBS display upon return from the external protocol.  AceComm completely
  3036.   disables the serial port before calling any external programs.
  3037.  
  3038.  
  3039. PreAutoM MACRO
  3040.  
  3041.   The "PreAutoM" MACRO, if defined, will be processed prior to the AutoM MACRO
  3042.   about to be processed.  This allows for some extra maneuvering to be done
  3043.   which might otherwise be common to all AutoM MACROS anyway.  For instance the
  3044.   practice of changing to your "FILES" directory will insure that downloads are
  3045.   received into the "FILES" directory, even with protocols that do not allow
  3046.   file redirection.
  3047.  
  3048.   Notes: If you use PreAutoM MACRO for changing directories, remember that
  3049.          protocols such as BIMODEM which you may be up loading with at the same
  3050.          time, will need full path names to files they are to send.  Also
  3051.          protocols or what have you that use PRM, CFG etc.  files need know
  3052.          where to find these control files.
  3053.  
  3054.  
  3055. PostAutoM MACRO
  3056.  
  3057.   The "PostAutoM" MACRO, if defined will be processed immediately following the
  3058.   AutoM MACRO.  Again this is some extra MACRO processing power for those
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.        Page 48              AceComm (tm) v 1.85
  3066.  
  3067.  
  3068. Chapter 4  PRM-data Menus Area
  3069.  
  3070.            Auto Engage Protocols (continued)
  3071.  
  3072.   common to all AutoM MACRO jobs.
  3073.  
  3074.  
  3075. To Disable Auto Engage Sequence Triggers
  3076.  
  3077.   Located in the "Terminal Area Options" is a over ride flag with which Auto
  3078.   downloads may be completely disabled.  This flag affects all Sequence
  3079.   Trigger / AutoM MACROS pairs defined.
  3080.  
  3081.   Auto Engage                            On    <=-ENABLE
  3082.   Auto Engage                            Off   <=-DISABLE
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088. ╔═Auto Log On Technology═════════════════════════════════════════════════════╗
  3089. ║═Trigger Sequence -- Responding Macro Stack═════════════════════════════════║
  3090. ║>is your name:       <SendStr>[USER_NAME]^M~Y^M~[FON_PWD]^M                 ║
  3091. ║ Your FIRST name:    <SendStr>[USER_NAME]^MY^M~[FON_PWD]^M                  ║
  3092. ║ Host Name:          <SendStr>CIS^M~~[FON_ID]^M~~[FON_PWD]^M                ║
  3093. ║ first name ?        <SendStr>[USER_NAME]^MY^M[FON_PWD]^M                   ║
  3094. ║ and LAST name:      <SendStr>[USER_NAME]^M~^M~[FON_PWD]^M                  ║
  3095. ║ last name?          <SendStr>[USER_NAME]^M~~[FON_PWD]^M                    ║
  3096. ║ first name?         <SendStr>[USER_NAME]^M~~[FON_PWD]^M                    ║
  3097. ║ (First and Last)    <SendStr>[USER_NAME]^M~~[FON_PWD]^M                    ║
  3098. ║ full name?          <SendStr>[USER_NAME]^M~^M[FON_PWD]^M                   ║
  3099. ║                                                                            ║
  3100. ║                                                                            ║
  3101. ║═Case  Off══════════════════════════════════════════════════════════════════║
  3102. ╚═══(Edit) Toggle_Case  Quit  Help ┤<>v^├════════════════════════════════════╝
  3103.  
  3104. o Each Fon.Record FLAGS can be toggled to perform auto log on by either use of
  3105.   a script file, or character sequence trigger and associated macro stack.
  3106.  
  3107. o AceComm responds to a sequence trigger by processing the macro stack.
  3108.  
  3109. o Log on sequence trigger scanning is available immediately after connect, and
  3110.   until the sequence has been found, or 2 minutes of on line time has passed.
  3111.  
  3112. o When a log on sequence has been processed, or 2 minutes of on line time has
  3113.   passed AceComm stops scanning for log on sequences for the remainder of the
  3114.   on line session.
  3115.  
  3116. o Sequence triggers are optionally CASE or nO cASE sensitive
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.        Page 49              AceComm (tm) v 1.85
  3125.  
  3126.  
  3127. Chapter 4  PRM-data Menus Area
  3128.  
  3129.            "Intelligent Auto Log On Technology" (tm)
  3130.  
  3131. On Dial/Connect Acecomm will, if the AutoL flag for the current Fon.Record is
  3132. SET, begin scanning incoming data for Auto Log On Sequence Triggers.  When any
  3133. of the 10 possible sequences is found, the sequence's associated macro stack is
  3134. processed.  Once a sequence has been found, scanning stops until the next
  3135. Dial/Connect.  If a sequence has not been found after the first 2 minutes of on
  3136. line time has passed, Intelligent Auto Log On (Tm) is disabled until the next
  3137. Dial/Connect.
  3138.  
  3139.  
  3140. Toggle_Case
  3141.  
  3142.   The setup menu contains an option where sequence trigger scanning can be made
  3143.   case sensitive.  AceComm's default setup is for scanning to be not case
  3144.   sensitive.
  3145.  
  3146.  
  3147. Sequence Trigger
  3148.  
  3149.   A sequence trigger is a character string that is used by a remote HOST,
  3150.   protocol etc.  as an attempt to engage some action from the other end.
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.        Page 50              AceComm (tm) v 1.85
  3184.  
  3185.  
  3186.  
  3187. Trigger Character
  3188.  
  3189.   AceComm scans back thru it's receive buffer for a trigger sequence with each
  3190.   occurrence of the "last byte of the sequence".  This means that AceComm will
  3191.   scan for the string each time it sees the trigger byte arrive from the
  3192.   modem.  For this reason a sequence trigger will end in a non-common byte.
  3193.   While 'rz^M' (^M being <CR>, 13 decimal) would be a valid sequence trigger,
  3194.   we don't want AceComm to search on every carriage return character that comes
  3195.   in.  Look at Bimodem's sequence trigger, we don't want to end the sequence
  3196.   with a <SP> character (^' is the control code for SPACE CHARACTER 32
  3197.   decimal).
  3198.  
  3199.   Characters 32(Space) and below need be escape encoded with the '^' ^A becomes
  3200.   1, ^B 2, ^C 3, ^M <CR>, ^` 32 <SP> etc.  When entering sequence text, you may
  3201.   simply type the <SP> character, AceComm will do the conversion for you.
  3202.  
  3203.  
  3204. To Disable Auto Log On Sequence Triggers Located in the
  3205.  
  3206.   "Fon.Record Edit" FLAGS menu is a over ride flag with which Auto Log On for
  3207.   the record may be completely disabled.  This flag only affects the currently
  3208.   selected record.
  3209.  
  3210.  Closer Look
  3211.  
  3212.  is your name:       <SendStr>[USER_NAME]^M~Y^M~[FON_REC_PWD]^M
  3213.   |                   |        |                 |
  3214.   |                   |        |                 Fon.Record
  3215.   Sequence Trigger    |        |                 password field
  3216.                       |        |
  3217.                       |        IEMSI data field
  3218.                       |
  3219.                       Associated macro stack
  3220.  
  3221.  AceComm provides two different data macros for passwords
  3222.  
  3223.    [PASSWORD]  represents the IEMSI password field
  3224.  
  3225. [FON_REC_PWD]  represents the current Fon.Record
  3226.                password field
  3227.  
  3228. Fon.Record password fields can be cloned for the entire FON file using the
  3229. "Mass_change" menu selection from inside the Telephone directory list area.
  3230.  
  3231.  
  3232.  
  3233. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3234. ░░░░░░┌─Paint Screens - Video Controls────────────┐░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3235. ░░░░░░│ Status line color                         │░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3236. ░░░░░░│ Curtain color                             │░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.        Page 51              AceComm (tm) v 1.85
  3244.  
  3245.  
  3246. Chapter 4  PRM-data Menus Area
  3247.  
  3248.            Mass Menu Attribute Changes
  3249.  
  3250. ░░░░░░│ Help screen color                         │─────────┐░░░░░░░░░░░░░░░░░
  3251. ░░░░░░│>Paint Menus                               │─────────│░░░░░░░░░░░░░░░░░
  3252. ░░░░░░│ Update All Menus                          │s        │░░░░░░░░░░░░░░░░░
  3253. ░░░░░░│ Video snow checking   Off                 │         │░░░░░░░░░░░░░░░░░
  3254. ░░░░░░│ Video Rows (VGA)      Detect              │         │░░░░░░░░░░░░░░░░░
  3255. ░░░░░░│─"Update" uses values below────────────────│         │░░░░░░░░░░░░░░░░░
  3256. ░░░░░░│       Border Attr     7                   │         │░░░░░░░░░░░░░░░░░
  3257. ░░░░░░│       Border Type     0                   │s        │░░░░░░░░░░░░░░░░░
  3258. ░░░░░░│       Title Color     120                 │hnology" │░░░░░░░░░░░░░░░░░
  3259. ░░░░░░│      ITitle Color     10                  │ls       │░░░░░░░░░░░░░░░░░
  3260. ░░░░░░│    Selector Color     2                   │         │░░░░░░░░░░░░░░░░░
  3261. ░░░░░░│  Left Field Color     3                   │         │░░░░░░░░░░░░░░░░░
  3262. ░░░░░░│ Right Field Color     7                   │         │░░░░░░░░░░░░░░░░░
  3263. ░░░░░░│        Burst Mode     Off                 │         │░░░░░░░░░░░░░░░░░
  3264. ░░░░░░│      Menu Chatter     Off                 │         │░░░░░░░░░░░░░░░░░
  3265. ░░░░░░│      Menu Whistle     Off                 │─────────┘░░░░░░░░░░░░░░░░░
  3266. ░░░░░░└─── Select  Quit ┤<>v^├────────────────────┘░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3267. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3268. ┌─  Customizer        <ENTER>-Select ─────────────────────────────────────────
  3269. │    Paint_Border  Type_Border  Left_Field  Right_Field  Title  ITitle
  3270. └─── Selector  Display  Burst Off Chatter Off Whistle Off Quit ┤<>v^├─────────
  3271. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3272.  
  3273. o Here you can play with the colors for this menu only, unless you choose the
  3274.   "Update All Menus" option
  3275.  
  3276.  
  3277. Status Line Color
  3278.  
  3279.   Toggle the AceComm status line back ground color (1 - 7)
  3280.  
  3281.  
  3282. Curtain Color
  3283.  
  3284.   Toggle color of back drops for various Areas
  3285.  
  3286.  
  3287. Customize
  3288.  
  3289.   All changes are limited to the current active menu "Mass Box".  Just as
  3290.   selecting the "Customize" option from any other menu, changes are reflected
  3291.   and remain permanent.
  3292.  
  3293.  
  3294. Help Screen Colors
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.        Page 52              AceComm (tm) v 1.85
  3303.  
  3304.  
  3305. Chapter 4  PRM-data Menus Area
  3306.  
  3307.            Mass Menu Attribute Changes (continued)
  3308.  
  3309.   AceComm's on line help uses 4 separate colors.  Certain error conditions can
  3310.   trigger a help screen to be displayed.  When this occurs, the error message
  3311.   is displayed at the top of the help screen, followed by the help screen's
  3312.   Title, help text, and bottom selector bar.
  3313.  
  3314.  
  3315. Update All Menus
  3316.  
  3317.   Selecting this option write a clone of the active menu "Mass Box" to *all*
  3318.   AceComm menus except the Fon List menu, and Dial/Edit Record menus.  The Fon
  3319.   List area menus have their own Paint options.
  3320.  
  3321.  
  3322. Snow (vertical retrace) checking     Off
  3323.  
  3324.   AceComm uses direct video buffer writes for all it display areas.  Most areas
  3325.   will be able to handle SNOW CHECKING properly before making screen updates.
  3326.  
  3327.  
  3328. Video Rows (VGA)                     Detect
  3329.  
  3330.    ┌─Video Rows (VGA)──────────────────────────┐
  3331.    │>Detect                                    │
  3332.    │ 25 rows                                   │
  3333.    │ 28 rows                                   │
  3334.    │ 43 rows                                   │
  3335.    │ 50 rows                                   │
  3336.    └─── Select  Quit ┤<>v^├────────────────────┘
  3337.  
  3338.  
  3339. The values on the right side of the menu are in decimal.  They may be copied
  3340. and used in the .CTL file as defaults.  (See ACE.CTL(1) "Menu Attributes")
  3341.  
  3342. ╔═  Customizer        <ENTER>-Select ═══════════════════════════
  3343. ╚═══ Color_Border  Type_Border  Left_Field  Right_Field   More
  3344. ................................................................
  3345. ╔═  Customizer        <ENTER>-Select ═══════════════════════════
  3346. ╚═══ Title  ITitle  Selector  Burst On Chatter Off Whistle On
  3347.  
  3348.  
  3349.  
  3350. (1) ACE.CTL may be renamed.  AceComm package contains the default ,CTL file
  3351.      ACE.CTL, but it may be renamed to another filename.
  3352.  
  3353.  
  3354.  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.        Page 53              AceComm (tm) v 1.85
  3362.  
  3363.  
  3364. Chapter 4  PRM-data Menus Area
  3365.  
  3366.            IEMSI Data
  3367.  
  3368.  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3369.  ░░░░░░░╔═IEMSI Data═══════════════════════════════════════════╗░░░
  3370.  ░░░░░░░║> User Name  Michael Phelps                           ║░░░
  3371.  ░░░░░░░║      Alias  MGP Software/(AceComm)                   ║░░░
  3372.  ░░░░░░░║   Location  Phoenix, AZ  USA                         ║░░░
  3373.  ░░░░░░░║     Data #  (602) 846-2940                           ║░░░
  3374.  ░░░░░░░║    Voice #                                           ║░░░
  3375.  ░░░░░░░║   Password  acecomm                                  ║░░░
  3376.  ░░░░░░░║    CRT def  ANSI,24,80,0                             ║░░░
  3377.  ░░░░░░░║  Protocols  Zap,ZMO                                  ║░░░
  3378.  ░░░░░░░║ Capability  CHT,TAB,ASCII8                           ║░░░
  3379.  ░░░░░░░║   Requests                                           ║░░░
  3380.  ░░░░░░░╚═══(Edit) Quit  Help ┤<>v^├═══════════════════════════╝░░░
  3381.  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3382.  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3383.  
  3384.  
  3385. o Electronic Mail Standard Identification (EMSI)
  3386.  
  3387. o EMSI is a widely used handshake protocol used with FIDONET mailer software
  3388.  
  3389. o Interactive Electronic Mail Standard Identification (IEMSI)
  3390.  
  3391. o IEMSI is an auto log on interface designed to present caller information to
  3392.   the HOST quickly and automatically.  Few BBS systems currently support
  3393.   IEMSI.  RA supports IEMSI log on.
  3394.  
  3395. o Interactive EMSI log on function is called with the <SendEMSI_ICI> MACRO
  3396.   function
  3397.  
  3398. o Data defined here will be used by the <SendEMSI_ICI> MACRO function
  3399.  
  3400. o All IEMSI data need not be defined.  The BBS system will prompt the user for
  3401. any invalid or missing information.
  3402.  
  3403.  
  3404.  
  3405. IEMSI handshake data
  3406.  
  3407. User Name and Alias
  3408.  
  3409.   Enter your name as you want it to appear to a BBS system.  There is also a
  3410.   PRM-data MACRO [USER_NAME] that uses this field.
  3411.  
  3412.   There is also a PRM-data MACRO [ALIAS] that uses this field.
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.        Page 54              AceComm (tm) v 1.85
  3421.  
  3422.  
  3423. Chapter 4  PRM-data Menus Area
  3424.  
  3425.            IEMSI Data (continued)
  3426.  
  3427.  
  3428. Location
  3429.  
  3430.   City, State, Country
  3431.  
  3432.   There is also a PRM-data MACRO [LOCATION] that uses this field.
  3433.  
  3434.  
  3435. Data # and Voice #
  3436.  
  3437.   If you have no Data #, leave the field blank.  There is also a PRM-data
  3438.   MACRO [DATA_PNUM] that uses this field.
  3439.  
  3440.   There is also a PRM-data MACRO [DATA_PNUM] that uses this field.
  3441.  
  3442.  
  3443. Password
  3444.  
  3445.   This is a default password, any FON.RECORD.PASSWORD always will override this
  3446.   IEMSI PASSWORD.
  3447.  
  3448.   There is also a PRM-data MACRO [PASSWORD] that uses this field.
  3449.   Note: [fon_rec_pwd] is used to represent the Fon.Record password field
  3450.  
  3451. Birthdate (currently unused)
  3452.  
  3453.  
  3454. CRT def    (current session only)
  3455.  
  3456.       ╔═CRT Def═════════════════╗
  3457.       ║>AVATAR/0+ / ANSI        ║
  3458.       ║ ANSI X3.64              ║
  3459.       ║ TTY (raw mode)          ║
  3460.       ╚═══ Select  Quit ┤<>v^├══╝
  3461.  
  3462.   Consists of four sub-fields separated by commas, from left to right:TERMINAL
  3463.   EMULATION,ROWS,COLUMNS,NULS
  3464.  
  3465.   AceComm fills in the ROWS,COLUMNS,NULS fields automatically when building
  3466.   IEMSI data packets.
  3467.  
  3468.                        Example CRTDEF: AVT0,24,80,0
  3469.  
  3470.   TERMINAL EMULATION
  3471.   Video type
  3472.                               AVT0        (AVATAR/ANSI)
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.        Page 55              AceComm (tm) v 1.85
  3480.  
  3481.  
  3482. Chapter 4  PRM-data Menus Area
  3483.  
  3484.            IEMSI Data (continued)
  3485.  
  3486.                               ANSI
  3487.                               TTY
  3488.   ROWS
  3489.          Video rows for current session only
  3490.   COLUMNS
  3491.          Video columns for current session only
  3492.   NULS
  3493.          00h character required after line feeds.
  3494.  
  3495.  
  3496. Protocols
  3497.  
  3498.   ╔═Protocols═════════════════════════╗
  3499.   ║>ZedZap (Zmodem to 8k)        Yes  ║
  3500.   ║ Zmodem                       Yes  ║
  3501.   ╚═══ Select  Quit ┤<>v^├════════════╝
  3502.  
  3503.   AceComm internal protocols support ZMO,ZAP fields.
  3504.  
  3505.   ZMO is normal zmodem
  3506.  
  3507.   ZAP is zmodem with up to 8k data frames.
  3508.  
  3509.  
  3510. Capability    (current session only)
  3511.  
  3512.   ╔═Capabilities══════════════════════╗
  3513.   ║>Can do full screen chat      Yes  ║
  3514.   ║ Can handle TAB characters    Yes  ║
  3515.   ║ Can handle 8-bit characters  Yes  ║
  3516.   ╚═══ Select  Quit ┤<>v^├════════════╝
  3517.  
  3518.   CHT       Can do full screen on line conversation (CHAT)
  3519.  
  3520.   TAB Can handle TAB (ASCII 09h) characters AceComm supports TAB
  3521.  
  3522.   ASCII8    Can handle 8-bit IBM PC ASCII characters
  3523.  
  3524.  
  3525. Requests      (current session only)
  3526.  
  3527.   ╔═Requests══════════════════════════╗
  3528.   ║>Show bulletins,announcements Yes  ║
  3529.   ║ Check for new mail           Yes  ║
  3530.   ║ Check for new files          Yes  ║
  3531.   ║ Hot-keys                     Yes  ║
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.        Page 56              AceComm (tm) v 1.85
  3539.  
  3540.  
  3541. Chapter 4  PRM-data Menus Area
  3542.  
  3543.            IEMSI Data (continued)
  3544.  
  3545.   ║ Screen clearing              Yes  ║
  3546.   ║ Do not disturb               Yes  ║
  3547.   ║ Page pausing, `More`         Yes  ║
  3548.   ║ Full-screen editor           Yes  ║
  3549.   ╚═══ Select  Quit ┤<>v^├════════════╝
  3550.  
  3551.   NEWS      Show bulletins, announcements, etc.
  3552.  
  3553.   MAIL      Check for new mail
  3554.  
  3555.   FILE      Check for new files
  3556.  
  3557.   HOT       Hot keys "ON"
  3558.  
  3559.   CLR       Screen clearing
  3560.  
  3561.   HUSH      Do not disturb
  3562.  
  3563.   MORE      Page pausing, often referred to as "More"
  3564.  
  3565.   FSED      Full screen editor
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.        Page 57              AceComm (tm) v 1.85
  3598. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3599.  
  3600. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3601.  
  3602.  
  3603.  
  3604.  
  3605. ╔═Receiver Protocols══════════════════════════════════════════
  3606. ║═Internal════════════════════════════════════════════════════
  3607. ║>Zmodem   1K/8K adoptive
  3608. ║ Ymodem  128/1K adoptive
  3609. ║ YmodemG
  3610. ║ Xmodem  128/1K adoptive
  3611. ║ Ascii file      XON/CTS
  3612. ║═External (user defined)═════════════════════════════════════
  3613. ║ <RunProg>BIMODEM /L%P /R[DIR_DNLDS] Bimodem.Pth
  3614. ║ <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  3615. ║ <RunProg>MPT P%P N+ F+ R+ R [DIR_DNLDS]
  3616. ║ <RunProg>JMODEM %PF %WK
  3617. ║ <RunProg>DSZ port %P speed %B rz -mrr [DIR_DNLDS]
  3618. ║ <RunProg>OZBEXT /B%B /C%P /F[DIR_DNLDS] /J /U /X
  3619. ║
  3620. ║
  3621. ║
  3622. ║
  3623. ║ Setup Menu (Externals)
  3624. ║═Auto Engage Menu════════════════════════════════════════════
  3625. ║ Setup Menu (Auto Engage)
  3626. ║═EMSI Protocol═══════════════════════════════════════════════
  3627. ║ Recv Mail / File Request
  3628. ╚═(Select) Options  Quit  Help ┤<>v^├═════════════════════════
  3629.  
  3630.  
  3631. AceComm contains internal Xmodem, Xmodem 1k, Ymodem, Ymodem 1k, Ymodem G,
  3632. Zmodem, and a Zmodem variant ZedZap (8k).
  3633.  
  3634.  
  3635. Internal Batch Capable
  3636. ----------------------
  3637. Batch protocols receive the incoming filenames as part of the file data sent
  3638. from the sender.  AceComm will append filenames received from the remote sender
  3639. to the directory path contained in the PRM-data area under "FILES".
  3640.  
  3641.  
  3642. Internal Single File
  3643. --------------------
  3644. Single file protocols require a filename be given locally, by the user.  The
  3645. user is prompted for a filename between the menu selection and calling the
  3646. internal protocol function.
  3647.  
  3648.  
  3649. Setup Menu Externals
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.        Page 58              AceComm (tm) v 1.85
  3657.  
  3658.  
  3659. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3660.  
  3661.            Internal and External Receive Protocols
  3662.  
  3663. --------------------
  3664. "Externals" are defined as menu selectable executable that will become
  3665. arguments to the <RunProgram> MACRO.
  3666.  
  3667. You may find it handy to assign some external protocols to a "Hot Key" from
  3668. inside PRM-data Key Definition menu.
  3669.  
  3670. ┌─ External Protocols (DnLd) ────────────────────────────────
  3671. │ <RunProg>BIMODEM /L%P /R[DIR_DNLDS] Bimodem.Pth
  3672. │ <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  3673. │ <RunProg>MPT P%P N+ F+ R+ R [DIR_DNLDS]
  3674. │ <RunProg>JMODEM %PF %WK
  3675. │ <RunProg>DSZ port %P speed %B rz -mrr [DIR_DNLDS]
  3676. │
  3677. │
  3678. │>
  3679. │
  3680. │
  3681. └─ Edit  Select  Quit ┤<>v^├─────────────────────────────────
  3682.  
  3683.  
  3684. Auto Engaging Menu
  3685. ------------------
  3686. Auto engaging protocols have sending units that begin by sending a documented
  3687. sequence of characters.  AceComm allows up to 10 separate sequences be defined,
  3688. and associates each sequence with a MACRO STACK.  the MACRO STACK can be setup
  3689. to call the external protocol associated with the sequence.  "AutoDnLds" is
  3690. documented in more detail above.  Shown below is a snippet reminder display.
  3691. You can enter high ascii characters by holding down the ALT key and typing from
  3692. the keypad.
  3693.  
  3694. ╔═Auto Engage Protocols════════════════════════════════════════════════════
  3695. ║═Trigger Sequence -- Responding Macro Stack═══════════════════════════════
  3696. ║>rz^M**              <RecvZmo>
  3697. ║ HS*^B               <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  3698. ║ ┬Θ═∩Σσφ             <RunProg>BIMODEM /L%P /R[DIR_DNLDS] Bimodem.Pth
  3699. ║ MPt ^V^H            <RunProg>MPT P%P N+ F+ R+ R [DIR_DNLDS]
  3700. ║
  3701. ║ **EMSI_REQA77E      <SendEMSI_CLI>
  3702. ║ **EMSI_IRQ8E08      <SendEMSI_ICI>
  3703. ║═Pre/Post AutoM Macros════════════════════════════════════════════════════
  3704.  
  3705.  
  3706.  
  3707. Recv Mail / File Request
  3708. ------------------------
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.        Page 59              AceComm (tm) v 1.85
  3716.  
  3717.  
  3718. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3719.  
  3720.            Internal and External Receive Protocols (continued)
  3721.  
  3722. "File Request" is a point mail function.
  3723. Selecting File Request function will bring up the menu below if the PRM-data
  3724. directory field for NODELIST.
  3725.  
  3726.  
  3727. ╔═════════════════════════════════════════════════════════════════════════
  3728. ║>1:114/35
  3729. ║ Format=> ZONE:NET/NODE
  3730. ║═Boss Data Menus═════════════════════════════════════════════════════════
  3731. ║  Boss Name               AceComm Support BBS
  3732. ║  Boss Addr               1:114/35
  3733. ║ Boss Phone               1-602-846-2940
  3734. ║   Boss Pwd               password
  3735. ║
  3736. ║
  3737. ║ c:\fil\NLIST.IDX
  3738. ║ c:\fil\nodelist.063
  3739. ╚═ Enter_address  Boss_call  Next_boss  Quit ┤<>v^├═══════════════════════
  3740.  
  3741.  This menu prompts the user for a ZONE:NET/NODE number of the system we want to
  3742.  call.
  3743.  
  3744. ╔════════════════════════════════════════════════════╗
  3745. ║    System Name MGP_Programming_Services            ║
  3746. ║           City Phoenix_AZ                          ║
  3747. ║  Operator Name Michael_Phelps                      ║
  3748. ║   Phone Number 1-602-846-2940                      ║
  3749. ║      Baud Rate 9600                                ║
  3750. ║          Flags V32                                 ║
  3751. ║       Password mailman                             ║
  3752. ╚═ File_Request  Human_call  Poll_for_Mail  Quit ════╝
  3753.  
  3754.  Notice the "Phone Number" field contains a long distance number.  The
  3755.  following "Dial Filter" statement" contained in "Phone Number Modifier" menu
  3756.  is used to convert the phone number to a local number.
  3757.       1-602-
  3758.        (A)        (B)
  3759.  Explanation: Field (A) defines what to look for in phone numbers Field (B)
  3760.               defines what to replace field (A) with.  Here we left field (B)
  3761.               blank.  AceComm then replaces "1-602-" with nothing.
  3762.  
  3763.  Notice the "Password field.  The following "Password" definition was made in
  3764.  "Point Mail Setup" menu.
  3765.       1:114/35 mailman
  3766.  
  3767.  The selector bar at the bottom of the above menu contains several choices.
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.        Page 60              AceComm (tm) v 1.85
  3775.  
  3776.  
  3777. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3778.  
  3779.            Internal and External Receive Protocols (continued)
  3780.  
  3781.  The first being "File Request".  Selecting "File Request" produces the
  3782.  following screen.
  3783.  
  3784.  ╔═Input Window═════════════════════
  3785.  ║══════════════════════════════════
  3786.  ║>FileName:  files
  3787.  ╚══════════════════════════════════
  3788.  
  3789.  AceComm is prompting for file names.  The example uses the file name "files".
  3790.  Many systems will recognize "files" as a MAGIC file name, and send an "all
  3791.  files listing" for the system in response.  Pressing <ENTER> alone when
  3792.  finished entering file names causes AceComm to begin dialing the target
  3793.  system.
  3794.  
  3795.      ╔══Record Number 1:114/35══════════════════════════════════
  3796.      ║>     System Name   MGP_Programming_Services
  3797.      ║     Phone Number   1-602-846-2940
  3798.      ║     Line Control   9600L,8N1
  3799.      ║       Video Type
  3800.      ║ Control Flags
  3801.      ║      Dial Prefix
  3802.      ║     Log on Script
  3803.      ║     Capture File
  3804.      ║         Password   mailman
  3805.      ║    Load KBD File
  3806.      ║  Log on triggers
  3807.      ║═Last Connect  --   Total Connects ═══════════════════════
  3808.      ║ 0
  3809.      ║═Cycles     --      Dial String                       Last
  3810.      ║   0                ATEQ0X4DT846-2940
  3811.      ║ 00:03    00:03     58
  3812.      ╚═│Quit│ <SpaceBar>-ReCycle ┤<>v^├═════════════════════════
  3813.  
  3814. ----------------------------------------------------------------
  3815.  AceComm (tm) Version 1.85 -- Copr 1990,1994 by Michael G Phelps
  3816. **E
  3817. Attemping EMSI handshake
  3818. Press ESC key several times for BBS
  3819.  
  3820. AceComm Software Support, 1:114/35
  3821. Michael Phelps, Phoenix, AZ(602) 846-2940
  3822.  AceComm,  Version 1.85, , 38400, V32b,CM,XA
  3823.   Outgoing  D:\ACE\00720023.REQ
  3824.  File Info  7 04/05/1994 16:52
  3825. 0        7        0 CPS        00:00:00        ZEOF
  3826. 0        7        0 CPS        00:00:00        ZEOF
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.        Page 61              AceComm (tm) v 1.85
  3834.  
  3835.  
  3836. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3837.  
  3838.            Internal and External Receive Protocols (continued)
  3839.  
  3840.                  CPS                ZDATA
  3841.   Incoming  D:\ACE\mgp-soft.zi2
  3842.  File Info  16030 04/02/1994 19:26
  3843.                  CPS                ZFIN
  3844. No carrier detect
  3845.                  CPS                ZGHDR
  3846. ----------------------------------------------------------------
  3847.  
  3848. AceComm uses it's text based display for the Point Mail protocol displays.
  3849.  
  3850.  
  3851.  
  3852.  
  3853. ╔═Sender Protocols════════════════════════════════════════════
  3854. ║═Internal════════════════════════════════════════════════════
  3855. ║>Zmodem 1K
  3856. ║ Zmodem 8K
  3857. ║ Ymodem
  3858. ║ Ymodem 1K
  3859. ║ YmodemG
  3860. ║ Xmodem
  3861. ║ Xmodem 1K
  3862. ║ Ascii file      XON/CTS
  3863. ║═External (user defined)═════════════════════════════════════
  3864. ║ <RunProg>BIMODEM /L%P /R[DIR_DNLDS] bimodem.pth
  3865. ║ <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  3866. ║ <RunProg>MPT P%P N+ F+ S @UPLDS.LST %WK
  3867. ║ <RunProg>JMODEM S %PF %WK
  3868. ║ <RunProg>DSZ port %P speed %B sz @[DIR_START]\UPLDS.LST
  3869. ║ <RunProg>OZBEXT /B%B /C%P /F[DIR_DNLDS] /J /U /X
  3870. ║
  3871. ║
  3872. ║
  3873. ║
  3874. ║ Setup Menu (Externals)
  3875. ║ Send Mail / File Attach
  3876. ╚═(Select) Options  Quit  Help ┤<>v^├═════════════════════════
  3877.  
  3878.  
  3879. AceComm contains internal Xmodem, Xmodem 1k, Ymodem, Ymodem 1k, Ymodem G,
  3880. Zmodem, and a Zmodem variant ZedZap (8k).
  3881.  
  3882. Internal Batch Capable
  3883. ----------------------
  3884. AceComm's internal "Batch" capable protocols are capable of sending from a
  3885. LISTFILE.  A LISTFILE is an ascii text file containing <CR> <LF> terminated
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.        Page 62              AceComm (tm) v 1.85
  3893.  
  3894.  
  3895. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3896.  
  3897.            Internal and External Sender Protocols
  3898.  
  3899. filenames.  One filename per line.  Filenames may contain a full DRIVE:\PATH
  3900. specifier.  AceComm looks in the current directory for a filename "UPLDS.LST".
  3901. When selecting any of the "Batch" capable internal sending units, AceComm will
  3902. always look for "UPLDS.LST", if the file exists, AceComm displays the following
  3903. screen.
  3904.  
  3905.  ╓─────────────────╖      AceComm always prompts to send the
  3906.  ║ Found UPLDS.LST ║   from the LISTFILE "UPLDS.LST", when the
  3907.  ║ Send contents?  ║   "UPLDS.LST" file exists in the directory.
  3908.  ║>(Y)es/(n)o?:    ║   Pressing <CR> defaults to (Y)es, (n)o
  3909.  ╙─────────────────╜   brings up the regular file selection
  3910.                        menu.
  3911.  
  3912.  
  3913.  ╓───────────────────╖      If the (Y)es selection was selected,
  3914.  ║ UPLDS.LST         ║   AceComm will, after the transfer,
  3915.  ║ Delete this file? ║   present the menu at left, prompting to
  3916.  ║>(Y)es/(n)o?:      ║   delete the LISTFILE, or leave it exist.
  3917.  ╙───────────────────╜
  3918.  
  3919.  
  3920.  
  3921. The "Regular file selection" menu (below) allows "on the fly" LISTFILE
  3922. creation.  The "on the fly" LISTFILE is not named "UPLDS.LST", but a temporary
  3923. unique filename is selected.  "On the fly" LISTFILE is deleted after transfer
  3924. without any prompt.
  3925.  
  3926.      ╓─Make Uploads List────────────────╖
  3927.      ║>Batch Tag                        ║
  3928.      ║ Manual entry                     ║
  3929.      ║ Finished  /  ESC-key             ║
  3930.      ╙─ Select  Quit ───────────────────╜
  3931.  
  3932.         Batch Tag
  3933.  
  3934.         This selection brings up the "FileLister" menu.  This menu allows
  3935.         tagging filenames to the LISTFILE.  PRM-data DIR "DNLDS" is the default
  3936.         directory displayed by "FileLister" when called by the "Sender
  3937.         Protocols" menu.
  3938.  
  3939.  
  3940.         Manual entry
  3941.  
  3942.         The menu below is presented with the "Manual entry" selection.
  3943.  
  3944.   ╓─Make Uploads List─────────────────╖
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.        Page 63              AceComm (tm) v 1.85
  3952.  
  3953.  
  3954. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3955.  
  3956.            Internal and External Sender Protocols (continued)
  3957.  
  3958.   ║ Batch Tag                         ║
  3959.   ║╓─Input Window───────────────────────────────────────────────
  3960.   ║║>FileName:  c:\fil\
  3961.   ╙║─Input Window<ENTER> alone when done────────────────────────
  3962.    ╙────────────────────────────────────────────────────────────
  3963.   The "Manual entry" filename prompt pre pends the prompt space with any PATH
  3964.   found in PRM-data DNLDS field.
  3965.  
  3966.  
  3967.   "Batch Tag/ Manual entry" are recorded to a temporary unique LISTFILE as
  3968.   explained above.  Temporary unique LISTFILE is automatically deleted after
  3969.   use.
  3970.  
  3971.  
  3972. Single File
  3973. -----------
  3974. AceComm's internal protocols that send 1 filename per invocation use the
  3975. "Manual entry" window shown below.
  3976.  
  3977.   ╓─Input Window───────────────────────────────────────────────
  3978.   ║>FileName:  c:\fil\
  3979.   ║─Input Window<ENTER> alone when done────────────────────────
  3980.   ╙────────────────────────────────────────────────────────────
  3981.  
  3982.  
  3983. External Protocols
  3984. ------------------
  3985. This selection brings up a menu listing up to five configurations for external
  3986. protocol setup/selection.  This menu allows storing configurations for external
  3987. protocols to be used.  The menu storage below functions the same as any MACRO
  3988. stack assigned to a key press.  Here you have a menu where you may find it
  3989. easier to to store specific upload protocol definitions.
  3990.  
  3991.  ╓─ External Protocols (UpLd) ──────────────────────────────────
  3992.  ║><RunProgram>BIMODEM %WK
  3993.  ║ <RunProgram>HSLINK %PF %WK
  3994.  ║ <RunProgram>MPT S @UPLDS.LST %WK
  3995.  ║ <RunProgram>JMODEM S %PF %WK
  3996.  ║ <RunProgram>DSZ sz %PF
  3997.  ╙─ Select  Edit  Quit ─────────────────────────────────────────
  3998.  
  3999.  
  4000. Send Mail / File Attach
  4001. -----------------------
  4002.   This selection allows the user to send files to EMSI capable mailer
  4003.   software.  The menu shown below prompts the user for a FIDONET style
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.        Page 64              AceComm (tm) v 1.85
  4011.  
  4012.  
  4013. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  4014.  
  4015.            Internal and External Sender Protocols (continued)
  4016.  
  4017.   ZONE:NET/NODE number.
  4018.  
  4019.  ╓───────────────────────────────────────╖
  4020.  ║>                                      ║
  4021.  ║ Format =>  ZONE:NET/NODE              ║
  4022.  ╙───────────────────────────────────────╜
  4023.  
  4024.   The number is required for naming a LISTFILE.  LISTFILE in this mode uses
  4025.   "FLO" file extension.  AceComm allows normal Tag or manual entry when adding
  4026.   filenames to LISTFILE.  Those who want to "File Attach" or are running under
  4027.   a HOST as a point mail system will use this option.  Point mail operators may
  4028.   upload their mail bundles with this "Send Mail" selection.  AceComm requires
  4029.   a NODELIST or FBL output .NOD file when using "Send Mail/Attach".  AceComm
  4030.   uses the ZONE:NET/NODE number entered above for looking up system information
  4031.   about the HOST to be called.  AceComm is able to retrieve the phone number
  4032.   and system name from NODELIST/.NOD files.
  4033.  
  4034.   
  4035.  
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.  
  4064.  
  4065.  
  4066.  
  4067.  
  4068.  
  4069.        Page 65              AceComm (tm) v 1.85
  4070. Chapter 6  Telephone Directory Area
  4071.  
  4072. Chapter 6  Telephone Directory Area
  4073.  
  4074.  
  4075. ╒═d:\ace\fon\ACE.FON, 21 Records══════════════════════════════════════════════
  4076. │═      System Name              Phone Number     Line Control Video  Last On
  4077. │>1  - AceComm Support          @846-2940!         19200,8N1   Av/An  30 Mar
  4078. │ 2    Albuquerque ROS <ASP>    1-505-299-5974     19200,8N1   Av/An  00
  4079. │ 3    Animal House             1-601-329-4217     19200,8N1   Av/An  00
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.  
  4102.  
  4103.  
  4104.  
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.        Page 66              AceComm (tm) v 1.85
  4129.  
  4130. │ 4  - Brian Brown (GAP)        1-813-398-4921     38400,8N1   Av/An  02 Mar
  4131. │ 5    CIS (local phoenix 9600) 468-0285           19200,7E1   Av/An  30 Mar
  4132. │ 6    CIS (phones)             1-800-346-3247     19200,7E1   Av/An  15 Feb
  4133. │ 7  - Comput Connections (PCB) 1-202-547-2008     19200,8N1   Av/An  26 Dec
  4134. │ 8    Eagan On-line            1-612-686-8806     19200,8N1   Av/An  00
  4135. │ 9  - Exec-PC <ASP>            1-414-789-4210     19200,8N1   Av/An  08 Feb
  4136. │ 10 - James Roberts (TRIBBS)   1-214-339-4495     19200,8N1   Av/An  01 Mar
  4137. │ 11   Leprechan Castle (SPIT)  1-601-799-2299     19200,8N1   Av/An  00
  4138. │ 12 - PC-Ohio <ASP>            1-216-381-3320     19200,8N1   Av/An  00
  4139. │ 13 - Senior Link              1-813-869-3700     38400,8N1   Av/An  21 Feb
  4140. │ 14   Supra Modem BBS          1-503-967-2444     19200,8N1   Av/An  00
  4141. │ 15 - Technoids Anonymous      1-602-899-5233     19200,8N1   Av/An  08 Feb
  4142. │ 16   The Flying Dutchman      1-406-452-4210     19200,8N1   Av/An  00
  4143. │ 17   The GaRBaGe DuMP <ASP>   1-505-294-5675     19200,8N1   Av/An  00
  4144. │ 18   The Hot Tub Chat Lounge  1-201-617-8054     19200,8N1   Av/An  00
  4145. │ 19 - Tool Shop,langs          1-818-891-6780     19200,8N1   Av/An  11 Feb
  4146. │ 20   Wizard's Gate <ASP>      1-614-224-1635     19200,8N1   Av/An  00
  4147. │  Dial  Edit  <SP>-Que  Circling_queue  Fon_files  Sort  Options  Type_#
  4148. ╘═ Add_record  Remove_record  Mass_Change  Import  Paint  Quit  Help ┤<>v^├═══
  4149.  
  4150.  
  4151. The Telephone Directory Area lists binary .FON files in their full ASCII
  4152. representation.  The current loaded .FON file is identified at the top of the
  4153. menu.  Notice that the number of records contained in the '1_114.FON' file is
  4154. presented at the top right.  .FON files are not fixed to any certain record
  4155. size, and can have records added or deleted, from here, in the Directory list
  4156. area.  Maximum record count for a FON file is 1000 records per FON file.
  4157. AceComm supports unlimited FON files, and provides easy directory List/Grab
  4158. function for changing FON files.
  4159.  
  4160. Dial
  4161. ----
  4162.   Dial the "highlighted" record.  The function continues dialing until:
  4163.  
  4164.      (a) a connection has been established
  4165.  
  4166.      (b)  USER ABORT.
  4167.  
  4168.  
  4169. Edit
  4170. ----
  4171.   Another menu contains the "highlighted" record's data is presented for
  4172.   editing, or just a closer view.  All changes are automatically save to disk.
  4173.  
  4174.  
  4175. <SP>-Que
  4176. --------
  4177.   Mark the "highlighted" record for 'RedialQue'.
  4178.  
  4179.  
  4180. Circling_Queue
  4181. --------------
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.        Page 67              AceComm (tm) v 1.85
  4189.  
  4190.  
  4191. Chapter 6  Telephone Directory Area
  4192.  
  4193.   Switch into The 'Que' Menu.  At least 1 record needs be marked "Queued" for
  4194.   AceComm to present this area.  From the 'Que' Menu, 'Dial' goes into single
  4195.   dial mode, and each record is dialed 1 time, followed by the next record
  4196.   until all records in the 'Que' have been dialed.  The 'Que' then revolves
  4197.   around to the first record and begins again.  When a connection has been
  4198.   established, the record is removed from the 'Que'.
  4199.  
  4200. ╔═ Circular_Redial_Que D:\ACE\1_114.FON, 6 Records══════════════
  4201. ║═      System Name            Phone Number     Line Control Vid
  4202. ║>14 - Artemis Lair bbs         1-602-841-4474     9600,8N1    A
  4203. ║ 15 - Astroland                1-602-381-8708     9600,8N1    A
  4204. ║ 16 - Bob's Place BBS Node 1   1-602-497-2173     2400,8N1    A
  4205. ║ 17 - Bob's Place BBS Node 2   1-602-545-8745     9600,8N1    A
  4206. ║ 18 - Broadcaster's BBS        1-602-872-9148     9600,8N1    A
  4207. ║ 19 - CADE BBS                 1-602-931-3468     2400,8N1    A
  4208. ║  Dial  Edit  <SPACEBAR>-Zap  Telephone_Directory
  4209. ╚═ Add_record  Remove_record  UnMark_All  Import  Paint  Quit ┤<
  4210.  
  4211.  
  4212. Fon_files
  4213. ---------
  4214.   List PRM-data directory .FON, allow selection of new .FON file
  4215.  
  4216.  
  4217. Sort
  4218. ----
  4219.   ┌─Sort FON file by ?─┐
  4220.   │>Number of calls    │
  4221.   │ Last date called   │
  4222.   │ System name field  │
  4223.   │ System number      │
  4224.   └─── Select  Quit ───┘
  4225.  
  4226.  
  4227. Options
  4228. -------
  4229.       ╔═Dialing Options═══════════════════════════════╗
  4230.       ║>Inter byte delay                         4    ║
  4231.       ║ Modem Response Timeout when dialing      65   ║
  4232.       ║ Seconds between re-dial                  1    ║
  4233.       ║ DTR state between re-dial                Off  ║
  4234.       ║ Ring BELL on Dial/Connect                1    ║
  4235.       ║ Hide PWD when dialing                    No   ║
  4236.       ║═Menus═════════════════════════════════════════║
  4237.       ║ Phone Number Modifiers                        ║
  4238.       ╚═══(Select) Quit  Help ┤<>v^├══════════════════╝
  4239.    ╔═Phone Number Modifiers═════════════════════════════════╗
  4240.    ║═Translate══════════════════════════════════════════════║
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.        Page 68              AceComm (tm) v 1.85
  4248.  
  4249.  
  4250. Chapter 6  Telephone Directory Area
  4251.  
  4252.   ╔║ Translate 1-602-846-4563 1-602-846-2940                ║
  4253.   ║║ Translate 1-602-292-0997 1-602-292-0997                ║
  4254.   ║║ Translate                                              ║
  4255.   ║║ Translate                                              ║
  4256.   ║║ Translate 1-602-                                       ║
  4257.   ║║═Long Distance Detect═══════════════════════════════════║
  4258.   ║║>Long Dist 1-                                           ║
  4259.   ║║═Replaceables═══════════════════════════════════════════║
  4260.   ║║ !                                                      ║
  4261.   ╚║ @                                                      ║
  4262.    ║ #                                                      ║
  4263.    ║ $                                                      ║
  4264.    ╚═══(Edit) Quit ┤<>v^├═══════════════════════════════════╝
  4265.  
  4266. See the sub chapter  "Dialing Options".
  4267.  
  4268.  
  4269. Type_#
  4270. ------
  4271.    Manual dial. Enter a phone number to de dialed. Does not get in the
  4272.    .FON file.
  4273.  
  4274.  
  4275. Add_record
  4276. ----------
  4277.   Function appends a new record to the current loaded .FON file, and
  4278.   immediately brings up the 'Edit' Menu.  The new record is automatically
  4279.   saved.
  4280.  
  4281.  
  4282. Remove_record
  4283. -------------
  4284.   The "highlighted" record is removed from the current loaded .FON file.  No
  4285.   hole is left, the .FON file is reduced a 'record size' in bytes.
  4286.  
  4287.  
  4288. Mass_Change
  4289. -----------
  4290.   ┌─Mass Change FON Records─┐
  4291.   │>     Dial Prefix        │
  4292.   │         Password        │
  4293.   │    Load KBD File        │
  4294.   │     Line Control        │
  4295.   │       Video Type        │
  4296.   │    Flags Control        │
  4297.   │       UnMark All        │
  4298.   └─── Select  Quit ┤<>v^├──┘
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.        Page 69              AceComm (tm) v 1.85
  4307.  
  4308.  
  4309. Chapter 6  Telephone Directory Area
  4310.  
  4311.   All records in a FON file can be updated at one time, with individual record
  4312.   member updates.
  4313.  
  4314.  
  4315. Import
  4316. ------
  4317.   o Convert another software's FON type file to AceComm FON file.
  4318.  
  4319.   o Merge two AceComm format FON files into one file.
  4320.  
  4321.   o Initialize a new FON file of video rows number of blank records.
  4322.  
  4323.   "Import" selection brings up the FON file conversion menu displayed below.
  4324.    The menu provides the following functions.
  4325.  
  4326.             ╔═Covert to AceComm FON══════╗
  4327.             ║                            ║
  4328.             ║  BOYAN    5                ║
  4329.             ║  Qmodem   4                ║
  4330.             ║  Qmodem   5                ║
  4331.             ║  Procomm  2.43             ║
  4332.             ║  PcPlus   1                ║
  4333.             ║  PcPlus   2                ║
  4334.             ║  Telemate 3.01 - 4.12      ║
  4335.             ║  TELIX    3.15 - 3.21      ║
  4336.             ║  Combine 2 Ace FON         ║
  4337.             ║  Create blank FON          ║
  4338.             ║> FON to PRN/File           ║
  4339.             ╚═══ Select  Quit ┤<>v^├═════╝
  4340.  
  4341.  
  4342. Paint
  4343. -----
  4344.   Customize the current menu only.  All changes are saved automatically.
  4345.   AceComm allows "Paint" for all but the "Phone List" and "Phone Dial/Edit"
  4346.   menus from inside the PRM-data area. "Phone List" and "Phone Dial/Edit"
  4347.   menus are paintable from their respective menus.
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.        Page 70              AceComm (tm) v 1.85
  4366.  
  4367.  
  4368. Chapter 6  Telephone Directory Area
  4369.  
  4370.  
  4371. Fon.Record Edit Menu
  4372.  
  4373.      ╒══Record Number 1════════════════════════════════════════════════════╕
  4374.      │>     System Name  AceComm Support                                   │
  4375.      │     Phone Number  @846-2940!                                        │
  4376.      │     Line Control  19200L,8N1                                        │
  4377.      │       Video Type  Av/An                                             │
  4378.      │    Control Flags  Macro,DTag,IEMSI,AutoL,LDF                        │
  4379.      │      Dial Prefix                                                    │
  4380.      │     LogOn Script  AceComm.SCR                                       │
  4381.      │     Capture File                                                    │
  4382.      │         Password  author                                            │
  4383.      │            Alias                                                    │
  4384.      │               ID                                                    │
  4385.      │    Load KBD File                                                    │
  4386.      │  Log on triggers  Case  Off                                         │
  4387.      │═Last Connect  --   Total Connects ══════════════════════════════════│
  4388.      │ 30 Mar                 220                                          │
  4389.      │═Cycles     --      Dial String                       Last Response ═│
  4390.      │   0               ATEQ0X4DT846-2940                                 │
  4391.      │   1378            00:00:00                                          │
  4392.      ╘═ Edit  Paint  Quit  Help ┤<>v^├═════════════════════════════════════╛
  4393.  
  4394.  
  4395. System Name            AceComm Software Support
  4396. -----------
  4397.   The name defined here, is presented onto the revolving status line (right
  4398.   side of status line) when "on line".
  4399.  
  4400.  
  4401. Phone Number           1-602-846-2940
  4402. ------------
  4403.   This phone number, although long distance, can be modified by AceComm when
  4404.   dialing, with use of "Translate" statements in the "Dialing Options" Menu.
  4405.   LFD flag must be set. (see "Flags" below)
  4406.  
  4407.   Example: lets say we are local Phoenix, where our area code is 602, we have
  4408.            an entire phone directory of long distance numbers.  The following
  4409.            dial statement defined inside "Point Mail Setup" will cause AceComm
  4410.            to translate all of the long distance numbers to local numbers.
  4411.  
  4412.            Dial 1-602-
  4413.  
  4414.            AceComm will see this definition and translate it into anything
  4415.            following the definition.  In this case, we did not put anything
  4416.            after the "1-602-", so AceComm will strip "1-602-" from all phone
  4417.            numbers that contain "1-602-" as part of the number.  This is valid
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.        Page 71              AceComm (tm) v 1.85
  4425.  
  4426.  
  4427. Chapter 6  Telephone Directory Area
  4428.  
  4429.            for all phone numbers that are processed thru the AceComm Dialer
  4430.            Menu.  Mailer mode, File Requests which get their phone numbers from
  4431.            either a FIDO NODELIST, of FBL output .NOD file do use the Dialer
  4432.            Menu and do receive number translation from "Dial" statements.
  4433.  
  4434.  
  4435. Line Control           19200,8N1
  4436. ------------
  4437.    Hi-speed mode users do not need to bother with the speed setting.  Typically
  4438.   you will leave your port locked at 19200 or faster.  AceComm does not alter
  4439.   the baud rate setting when the LOCKBAUD flag is set.  LOCKBAUD flag is
  4440.   located inside the "Serial Port Setup" "Line Control" menu.
  4441.  
  4442.   Most remote HOSTS will be set up using 8 data bits, No parity, and 1 stop
  4443.   bit.  Compuserve uses 7 data bits, Even parity, and 1 stop bit.  AceComm will
  4444.   configure the UART to assemble the in coming bit stream into characters,
  4445.   based on the configuration defined here.  Baud rate means nothing when
  4446.   LOCKBAUD is set, as is with the "L" appended to baud in this example.  Other
  4447.   wise, when LOCKBAUD is not set, AceComm will set the UART up to the
  4448.   Fon.Record baud rate.
  4449.  
  4450.   Note: When LOCKBAUD is not set, AceComm is also capable of resetting the baud
  4451.         rate to a connect string.  If you dial out at 2400, and connect at
  4452.         9600, and 9600 is detected in the the connect string, AceComm will
  4453.         automatically set the baud to 9600.
  4454.  
  4455.  
  4456. Terminal Emulation     Av/An
  4457. ------------------
  4458.   This option will present the Terminal emulations menu, you may select the
  4459.   video ,type you want associated with this record.  "Av/An means AVATAR and
  4460.   ANSI video emulation.
  4461.  
  4462.  
  4463. Control Flags     Macro,DTag,Cap,Text,IEMSI,AutoL,+CR,LDF
  4464. -------------    Script,         Raw,
  4465.  
  4466.        ╔═   Control Flags═════════════════╗
  4467.        ║>Tag dial attempts    On          ║
  4468.        ║ Auto log on method   Macro,      ║
  4469.        ║ Open Capture file on Off         ║
  4470.        ║ Capture mode         Text,       ║
  4471.        ║ Allow IEMSI log on   On          ║
  4472.        ║ Allow auto log on    On          ║
  4473.        ║ Add CR to LF         Off         ║
  4474.        ║ LD Filter            On          ║
  4475.        ╚═══ Edit  Quit ┤<>v^├═════════════╝
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.        Page 72              AceComm (tm) v 1.85
  4484.  
  4485.  
  4486. Chapter 6  Telephone Directory Area
  4487.  
  4488.  
  4489.   "Script"  when  set,
  4490.  
  4491.   AceComm will attempt to load and run the filename defined next to "AutoLogOn
  4492.   Script".  If a script file is not found, AceComm ignores the error and
  4493.   continues normal operation.  Notes: .SCR files are looked for in the
  4494.   directory defined inside PRM-data Area "SCR" sub directory.
  4495.  
  4496.  
  4497.   "Macro"  when  set,
  4498.  
  4499.   Use Auto Log On "Trigger Sequence / Macro Stack"
  4500.   AceComm will enable the defined Auto Log on Sequence Triggers and
  4501.   corresponding MACRO stacks. (see below)
  4502.  
  4503. ╔═Auto Log On Technology═════════════════════════════════════════════════════╗
  4504. ║═Trigger Sequence -- Responding Macro Stack═════════════════════════════════║
  4505. ║>is your name:       <SendStr>[USER_NAME]^M~Y^M~[FON_PWD]^M                 ║
  4506. ║ Your FIRST name:    <SendStr>[USER_NAME]^MY^M~[FON_PWD]^M                  ║
  4507. ║ Host Name:          <SendStr>CIS^M~~[FON_ID]^M~~[FON_PWD]^M                ║
  4508. ║ first name ?        <SendStr>[USER_NAME]^MY^M[FON_PWD]^M                   ║
  4509. ║ and LAST name:      <SendStr>[USER_NAME]^M~^M~[FON_PWD]^M                  ║
  4510. ║ last name?          <SendStr>[USER_NAME]^M~~[FON_PWD]^M                    ║
  4511. ║ first name?         <SendStr>[USER_NAME]^M~~[FON_PWD]^M                    ║
  4512. ║ (First and Last)    <SendStr>[USER_NAME]^M~~[FON_PWD]^M                    ║
  4513. ║ full name?          <SendStr>[USER_NAME]^M~^M[FON_PWD]^M                   ║
  4514. ║                                                                            ║
  4515. ║                                                                            ║
  4516. ║═Case  Off══════════════════════════════════════════════════════════════════║
  4517. ╚═══(Edit) Toggle_Case  Quit  Help ┤<>v^├════════════════════════════════════╝
  4518.  
  4519.  
  4520.   "DTag"  when  set,
  4521.  
  4522.   AceComm will tag un-successful dial attempts (busy, etc.) to the Que Dialer.
  4523.   An "-" character appears to the left of a Fon.Record's display line.  When
  4524.   this flag is not set, the only other way to tag a record is by manually
  4525.   selecting the menu option "<SPACEBAR>-Que" from the fon list display.
  4526.  
  4527.  "Capture"
  4528.  
  4529.  When this flag is selected, a capture file is opened upon Dial/Connect.  Any
  4530.  previously open capture file is first closed.
  4531.  
  4532.  
  4533.  "Raw"  when set,
  4534.  
  4535.  Data to capture file is as it comes in from the modem
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.        Page 73              AceComm (tm) v 1.85
  4543.  
  4544.  
  4545. Chapter 6  Telephone Directory Area
  4546.  
  4547.  
  4548.  
  4549.  "Text"  when set,
  4550.  
  4551.  Data to capture file is filtered of video control codes as applicable to the
  4552.  current Video type
  4553.  
  4554.  
  4555.  "IEMSI"
  4556.  
  4557.  Allow Interactive EMSI log on
  4558.  
  4559.  
  4560.  "AutoL"
  4561.  
  4562.  Allow auto log on methods (script/macro)
  4563.  
  4564.  "+CR"
  4565.  
  4566.  Add Carriage return to line feeds
  4567.  
  4568.  "LDF"
  4569.  
  4570.  Use Long Distance Filters
  4571.  Phone numbers will be scanned against those found under the "Translate" option
  4572.  located inside "Phone Number Modifiers" menu.
  4573.  
  4574.    String on left is replace with string on right
  4575.    Example for changing long distance numbers into local numbers
  4576.       1-602-    |
  4577.       |         |
  4578.       |         |_________________
  4579.       |                          |
  4580.       This will be replaced with this, stripping 1-602- from phone numbers
  4581.       Note: LDF flag must be set ON for any Fon.Records you want Translation
  4582.             to be used with. LDF can be set ON or OFF for an entire FON file
  4583.             all at once from inside the "Mass Updates" menu located inside
  4584.             the Phone list menu area.
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590. Dialing Prefix
  4591. --------------
  4592.   The Fon.Record dial prefix overrides The PRM-data default prefix.  If this
  4593.   field is null (blank), AceComm uses the PRM-data default dial prefix.
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.        Page 74              AceComm (tm) v 1.85
  4602.  
  4603.  
  4604. Chapter 6  Telephone Directory Area
  4605.  
  4606.  
  4607. AutoLogOn Script       ACE_S.SCR
  4608. ----------------
  4609.   When SCRIPT flag is set, for the current Fon.Record, AceComm will use this
  4610.   filename, opening it as a SCRIPT file, and run the contents.  This action
  4611.   takes place upon successful Dial/Connect.  If the filename does not exist,
  4612.   AceComm simply goes about it's business, and you will log on normally.
  4613.   AceComm will look for the SCRIPT filename in PRM-data DIR .SCR path.
  4614.  
  4615.   See also: Expandable Macro Parameters <SendStr> [FON_SCR]
  4616.  
  4617.  
  4618. Capture File           ACE_S.CAP
  4619. ------------
  4620.   Default filename presented to user when opening a "capture data to file"
  4621.   file.
  4622.  
  4623.   <SendStr> [FON_CAP]
  4624.   See also: Expandable MACRO Parameters
  4625.  
  4626.  
  4627. Password               my/password
  4628. --------
  4629.   You may define the Fon.Record PASSWORD field to any character combination,
  4630.   the field maximum length is 19 characters.
  4631.  
  4632.   <SendStr> [FON_PWD]
  4633.   will replace "[FON_PWD]" with "my/password" for this example.
  4634.   See also: Expandable MACRO Parameters
  4635.  
  4636.  
  4637. Alias               Michael Phelps/AceComm
  4638. -----
  4639.  
  4640.   <SendStr> [FON_ALIAS]
  4641.   See also: Expandable MACRO Parameters
  4642.  
  4643.  
  4644. ID                 75120,3306
  4645. --
  4646.  
  4647.   <SendStr> [FON_ID]
  4648.   See also: Expandable MACRO Parameters
  4649.  
  4650.  
  4651. Custom .KBD File       CUSTOM.KBD
  4652. ----------------
  4653.    You can ask AceComm to load a custom key board definition file upon
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.        Page 75              AceComm (tm) v 1.85
  4661.  
  4662.  
  4663. Chapter 6  Telephone Directory Area
  4664.  
  4665.    Dial/Connect for the Fon.Record. This is not video related.
  4666.  
  4667.   AceComm will first remember what the current "KBD" filename is, load the
  4668.   Fon.Record's custom "KBD" file, if defined, and finally restore the original
  4669.   KBD file after session disconnect.  Say What?
  4670.  
  4671.   You are about to log onto Compuserve.  You have CIS.KBD file defined for the
  4672.   Fon.Record.  When dial/connect is detected, AceComm will load the contents of
  4673.   CIS.KBD, overlaying your current keyboard MACRO assignments.  When you log
  4674.   off of Compuserve, and AceComm detects the carrier drop (no DCD), AceComm
  4675.   will load back the original keyboard file, overlaying your custom CIS.KBD.
  4676.  
  4677.   You will need to distinguish KBD files from KTS files.  Where a KBD file
  4678.   overlays the keyboard MACRO assignments.  The KTS file defines the ultimate
  4679.   sequence that will be sent to the modem for a given key-press.  Keys assigned
  4680.   a MACRO, are processed as MACRO functions.
  4681.  
  4682.   Keys not assigned a MACRO(s) will be sent to the modem, and are candidates
  4683.   for KTS.
  4684.  
  4685.   Keys with extended codes, are sent as they would be seen in DoorWay mode.
  4686.   Normal keys (a-z,A-Z,1-0,CTRL A-CTRL Z, etc.) are sent in their normal lower
  4687.   ascii representation (as you would expect).  Now, any of these key-presses
  4688.   that have been defined inside the KTS file, are translated into their defined
  4689.   sequence.  AceComm & Utilities provides ASCII examples for compiling KTS
  4690.   files, as well as KTS.EXE the custom Keyboard Sequence Translation (Tm)
  4691.   compiler.
  4692.  
  4693.  
  4694. Log on Triggers
  4695. ---------------
  4696.   AceComm will respond to a sequence trigger by processing the MACRO stack.
  4697.   Log on sequence trigger scanning is available immediately after connect, and
  4698.   until the sequence has been found.  When a log on sequence has been
  4699.   processed, AceComm stops scanning for the log on sequence.  Auto logon method
  4700.   can be set in the flags menu.
  4701.  
  4702.  
  4703.  
  4704.  
  4705.  
  4706.  
  4707.  
  4708.  
  4709.  
  4710.  
  4711.  
  4712.  
  4713.  
  4714.  
  4715.  
  4716.  
  4717.  
  4718.  
  4719.        Page 76              AceComm (tm) v 1.85
  4720. Chapter 7  Auto Answer Setups
  4721.  
  4722. Chapter 7  Auto Answer Setups
  4723.  
  4724.  
  4725.  
  4726. o AceComm will process a macro stack based on the Answer/Connect string
  4727.  
  4728. o Auto Answer can be an EVENT, see "Event Scheduler" menu
  4729.  
  4730. o See the notes at the end of this chapter about <AutoAnswer> macro
  4731.  
  4732. This setup is available upon Asnwer/Connect, only if a Schedule is active and
  4733. include ",Host" as an attribute flag.
  4734.  
  4735. ╔═Auto Answer Setups════════════════════════════════════════════════
  4736. ║═Answer/Connect - Associated macro stack═══════════════════════════
  4737. ║>CONNECT
  4738. ║ <ChgDir>C:\BBS <RunProg>BBS %P %C <ChgDir>[DIR_START]
  4739. ║═Answer/Connect - Associated macro stack═══════════════════════════
  4740. ║ FAX
  4741. ║ <RunProg>BGFAX /FAX %P Z
  4742. ║═Answer/Connect - Associated macro stack═══════════════════════════
  4743. ║ CARRIER
  4744. ║ <ChgDir>C:\BBS <RunProg>BBS %P %C <ChgDir>[DIR_START]
  4745. ║═Default macro stack═══════════════════════════════════════════════
  4746. ║ <ChgDir>C:\BBS <RunProg>BBS %P %C <ChgDir>[DIR_START]
  4747. ╚═══(Edit) Quit  Help ┤<>v^├════════════════════════════════════════
  4748.  
  4749. Answer/Connect
  4750. --------------
  4751.    The sub-string will be looked for in the actual modem response string upon
  4752.    Answer/Connect Strings are currently case sensitive.
  4753.  
  4754.  
  4755. Associated macro stack
  4756. ----------------------
  4757.    Macro stack will be processed on "sub-string" found
  4758.  
  4759.  
  4760. Default macro stack
  4761. -------------------
  4762.    Macro stack to process when sub-string search fails
  4763.  
  4764.  
  4765.  
  4766.  
  4767. <AutoAnswer> macro
  4768.  
  4769. The <AutoAnswer> macro is callable with or without a parameter.
  4770. Valid parameters are "ON", "OFF", NONE (no parameter)
  4771. No parameter to the <AutoAnswer> macro results in toggle.
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.        Page 77              AceComm (tm) v 1.85
  4779.  
  4780.  
  4781. Chapter 7  Auto Answer Setups
  4782.  
  4783.  
  4784. <AutoAnswer>ON          Turn auto answer mode ON
  4785. <AutoAnswer>OFF         Turn auto answer mode OFF
  4786. <AutoAnswer>            Toggle auto answer mode
  4787.  
  4788. Auto answer mode on, with no schedules will cause AceComm to answer the modem
  4789. when the phone rings. You will the terminal area.
  4790. <AutoAnswer> is provided for simple answer, call back verify etc. You cannot
  4791. gain access to the above "Auto Answer Setups" this way. You must use the
  4792. scheduler and ",Host" flag to access "Auto Answer Setups".
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.  
  4828.  
  4829.  
  4830.  
  4831.  
  4832.  
  4833.  
  4834.  
  4835.  
  4836.  
  4837.        Page 78              AceComm (tm) v 1.85
  4838. Chapter 8  Event Schedules
  4839.  
  4840. Chapter 8  Event Schedules
  4841.  
  4842.  
  4843.  
  4844. This is how to access the "Auto Answer Setup" functions.
  4845. For AceComm to check the "Auto Answer Setup" upon Dial/Connect, a schedule with
  4846. the ",Host" attribute must be active.
  4847.  
  4848. ╔═Event Schedules═════════════════════════════════════════════════════════════
  4849. ║═Active = No═════════════════════════════════════════════════════════════════
  4850. ║>Event 0:0-2:0,Mail,Host
  4851. ║ Macro
  4852. ║ Event 2:0-3:0,Mail,LD
  4853. ║ Macro
  4854. ║ Event 3:0-7:30,Mail,Host,ld
  4855. ║ Macro
  4856. ║ Event 7:30-12:00,Mail,Host
  4857. ║ Macro <ChgDir>d:\mail <RunProg>COMMAND /c renum.bat <ChgDir>[DIR_START]
  4858. ║ Event 12:0-17:20,Mail,Host,ld
  4859. ║ Macro <ChgDir>D:\MAIL <RunProg>QM scan pack <ChgDir>[DIR_START]
  4860. ║ Event 17:20-20:0,Mail,Host
  4861. ║ Macro
  4862. ║ Event 20:0-23:45,Mail,Host,ld
  4863. ║ Macro
  4864. ║ Event 23:45-23:59,Mail
  4865. ║ Macro
  4866. ║ Event 0:0-0:0,
  4867. ║ Macro xxx
  4868. ╚═══(Edit) Active  Quit  Help ┤<>v^├══════════════════════════════════════════
  4869. AceComm will watch the clock for any event start times.  When an event rolls
  4870. around the associated macro stack, if any will be processed.
  4871.  
  4872. ,Mail
  4873. -----
  4874. ",Mail" events tell AceComm that it is ok to process any *.FLO files contained
  4875. inside the "MAIL_OUT" directory.
  4876. ,Mail events by themselves (no ,Host) will cause the "Point Mail" "Mail Only"
  4877. macro stack to be processed upon detection of a human (BBS) caller. In other
  4878. words, ,Mail only events will not allow any but mail calls. The "Mail Only"
  4879. macro stack is provided as a hook into the situation. You can choose to
  4880. display a message saying that you are not currently accepting BBS calls, or
  4881. you can beat the system and run some other host software, or host script.
  4882. In any event. When a non-mail call is detected with ",Mail" but not ",Host"
  4883. attributes for the currently active schedule, AceComm runs the "Mail Only"
  4884. macro stack.
  4885.  
  4886. ,Host
  4887. -----
  4888. ",Host" events tell AceComm it is ok to Auto Answer the line when RING is
  4889. detected.  AceComm uses the UART RING bit and modem status change for detecting
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.        Page 79              AceComm (tm) v 1.85
  4897.  
  4898.  
  4899. Chapter 8  Event Schedules
  4900.  
  4901. RING.
  4902. This is how to access the "Auto Answer Setup" functions.
  4903. For AceComm to check the "Auto Answer Setup" upon Dial/Connect, a schedule with
  4904. the ",Host" attribute must be active.
  4905.  
  4906. (See Auto Answer Setups for more information about Auto Answer)
  4907.  
  4908.  
  4909. ,LD
  4910. ---
  4911. Long distance calls are allowed with this flag. AceComm detects long distance
  4912. phone numbers by checking the "Long Distance" field defined inside "Phone
  4913. Number modifiers" menu.
  4914. You can defeat the ",LD" requirement for long distance calls by un-defining
  4915. the "Long Distance" detection.
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.        Page 80              AceComm (tm) v 1.85
  4956. Chapter 9  User Definable Menus
  4957.  
  4958. Chapter 9  User Definable Menus
  4959.  
  4960.  
  4961.  
  4962. o  "User Menus" can be used to group similar macro stacks
  4963.    together into one menu
  4964.  
  4965. o  "User Menus" can be assigned to a hot key and popped up any time from the
  4966.    Terminal Area.
  4967.  
  4968.  
  4969. "User Menus" were designed to offer a means for grouping common macro stacks
  4970. into menus.  I wanted to be able to create, change menus and menu items at
  4971. will, as my on line needs changed.  "User Menus" allow this sort of
  4972. configuration flexibility.
  4973.  
  4974.  
  4975. Master "User"
  4976.    Below is the "User Menu" Master menu.  (macro is <Users>) A
  4977.    key-press may be assigned the <Users> macro as a hot key for
  4978.    this menu.  It lists all five "User" style menus available.
  4979.  
  4980.    Each individual "User Menu" can be assigned a hot key.
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.        Page 81              AceComm (tm) v 1.85
  5015.  
  5016.  
  5017. F10 =  │ File │ Setup │ Phone │ Transfer │ Users │ Help │
  5018.                                          ┌──────────────────────┐
  5019.                                          │>1  CIS Functions     │
  5020.                                          │ 2  OffLine Reader    │
  5021.                                          │ 3  User Menu #3      │
  5022.                                          │ 4  User Menu #4      │
  5023.                                          │ 5  User Menu #5      │
  5024.                                          └── Select  Quit  Help ┘
  5025.    Here the first two menus have been given titles.  The titles were entered
  5026.    from the setup menu discussed later on.
  5027.  
  5028.    The following macro can be used for the five "User Menus".
  5029.    You give the macro a parameter in the range of 1 - 5.
  5030.       <User>1
  5031.       <User>2
  5032.       <User>3
  5033.       <User>4
  5034.       <User>5
  5035.  
  5036.    To assign a hot key to the "User Menu" labeled "CIS Functions", go into the
  5037.    PRM-data area "Key Setup" menus and assign a key press to the <User>1 macro.
  5038.  
  5039.    Example:  F11 <User>1
  5040.  
  5041.    Each "User Menu" has a title and seven function slots.
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047.  
  5048.  
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  
  5055.  
  5056.  
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.  
  5065.  
  5066.  
  5067.  
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.  
  5074.        Page 82              AceComm (tm) v 1.85
  5075.  
  5076.  
  5077. Chapter 9  User Definable Menus
  5078.  
  5079.  
  5080. A "User Menu"
  5081.  
  5082.    Below is a "User Menu".
  5083.  
  5084. F10 =  │ File │ Setup │ Phone │ Transfer │ Users │ Help │
  5085.                                         ┌─CIS Functions─────────┐
  5086.                                         │>CIS Forums Script     │
  5087.                                         │ CIS Bill Script       │
  5088.                                         │ Compose Message       │
  5089.                                         │ IBMPRO Forum 2 File   │
  5090.                                         │ IBMCOM Forum 2 File   │
  5091.                                         │                       │
  5092.                                         │ CIS Msg Reference     │
  5093.                                         └─(Select) Edit  Quit ──┘
  5094.  
  5095.  
  5096.  
  5097. Setup "User"
  5098.  
  5099.    Below is the Setup menu for creating "User Menus".
  5100.  
  5101. ┌─User Menus────────────────────────────────────────────────────────────
  5102. │─Title field───────────────────────────────────────────────────────────
  5103. │>- CIS Functions
  5104. │─Description / Associated macro stack pairs────────────────────────────
  5105. │ / CIS Forums Script
  5106. │ \ <RunScript>cisforum.scr
  5107. │ / CIS Bill Script
  5108. │ \ <RunScript>cisbill.scr
  5109. │ / Compose Message
  5110. │ \ <SendAscii>%P
  5111. │ / IBMPRO Forum 2 File
  5112. │ \ <SendStr>go IbmPro^M <OpenCapture>ibmpro <Delay>7 <SendStr>Read New^M
  5113. │ / IBMCOM Forum 2 File
  5114. │ \ <SendStr>go IbmCom^M <OpenCapture>ibmcom <Delay>7 <SendStr>Read New^M
  5115. │ /
  5116. │ \
  5117. │ / CIS Msg Reference
  5118. │ \ <RunProg>List cis_msg.ref
  5119. └───(Edit) Quit  Help ┤<>v^├─────────────────────────────────────────────
  5120.  
  5121. Title field
  5122.  
  5123.    The Title field is 15 characters long, this will be the title that appears
  5124.    in you "User Menu".
  5125.  
  5126. Description / Associated macro stack pairs
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.        Page 83              AceComm (tm) v 1.85
  5134.  
  5135.  
  5136. Chapter 9  User Definable Menus
  5137.  
  5138.  
  5139.    "Description" fields are 20 characters, these will become the menu choices
  5140.    displayed from your "User Menu".
  5141.  
  5142.    "Associated macro stack" fields are 80 characters, these are the actions
  5143.    that take place when you select a "Description" choice.
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.        Page 84              AceComm (tm) v 1.85
  5193. Chapter 10  Point Mailer Setup
  5194.  
  5195. Chapter 10  Point Mailer Setup
  5196.  
  5197.  
  5198.  
  5199.  
  5200. Automated and Un-attended Mailer Services
  5201. -----------------------------------------
  5202. AceComm provides in the Schedule Setup menu, a means for controlling the times
  5203. of day that "Host Mode", and "Mail Services" take place.  The Scheduler can
  5204. limit long distance calls to strict time lines.  The scheduler provides 9
  5205. separate time schedules.  Each schedule may have 0 or more attribute flags.  A
  5206. schedule is define with a start time, a stop time, and what activities are
  5207. allowed during the schedule's time frame.  It not necessary to define any extra
  5208. activities to make use of the schedules.  Each schedule has an associated macro
  5209. stack.  The macro stack is processed when the schedule begins.  This can
  5210. provide a timed sequence of events.  You can configure the scheduler to do a
  5211. great number of automated and un-attended tasks at their pre-set times.  If
  5212. AceComm is started in the middle of an active schedule, the macro stack is
  5213. still processed.
  5214.  
  5215. We can give any schedule a ",Mail" attribute flag, and or ",Host, and or
  5216. "LD".  "LD" means long distance calls are allowed.  AceComm will look in the
  5217. MAIL_OUT directory for mail needing to be sent.  Out going mail files contain
  5218. their address built into the filename.  AceComm can find the phone number for
  5219. each system by looking up the address.  AceComm will look first at the 5 "Boss
  5220. Data" fields.  If an address is not found there, AceComm looks in the FidoNet
  5221. Nodelist file.  A utility IDX.EXE is provided as an index builder for the
  5222. Nodelist.  IDX.EXE crates a filename NLIST.IDX for the Nodelist file.
  5223. NLIST.IDX is a simple binary table of indexes into the Nodelist file.  This
  5224. allows AceComm to find a Zone:Ne/Node number very quickly.
  5225.  
  5226. Schedules that have the ",Mail" attribute, are allowed to dial out if out
  5227. going mail exists. ",Mail" is allowed to answer the phone. ",Mail" is not
  5228. allowed to allow human (BBS) callers. ",Mail" can send and receive mail. If a
  5229. mail call comes in during a ",Mail" only schedule, the session is allowed. If
  5230. a human (BBS) caller is detected, a macro stack is run. The macro stack is the
  5231. "Mail Only" macro stack. This is configurational in the above menu. It is
  5232. contained under the "Macros to run at:" window. Add ",Host" attribute flag
  5233. for human (BBS) callers to be allowed during ",Mail" schedules. What happens
  5234. if you have a ",Host" attribute and no ",Mail" for the schedule. AceComm will
  5235. still allow mail calls. AceComm may dial out as well. There is another flag
  5236. that allows out going mail.
  5237.  
  5238. Full Time Point
  5239. ---------------
  5240. Located in the "Options" menu below is the "Full Time Point flag.  The flag
  5241. exists so that point mail services may operate when schedules are not enabled,
  5242. or there is no current schedule active.  Point mail service do not except
  5243. calls.  Point mail services are for calling out.  Point mail services will not
  5244. call out when long distance numbers are detected, and an active schedule does
  5245.  
  5246.  
  5247.  
  5248.  
  5249.  
  5250.  
  5251.        Page 85              AceComm (tm) v 1.85
  5252.  
  5253.  
  5254. Chapter 10  Point Mailer Setup
  5255.  
  5256. not have the ",LD" attribute.  The key here is "detected".  If you do not want
  5257. to use the scheduler, and would like to make long distance file requests, you
  5258. can un-define the long distance detection.  In the "Phone number Modifiers"
  5259. menu there is a single field for long distance number detection.  Simply erase
  5260. it.  AceComm will allow long distance numbers any time.
  5261.  
  5262. Confused? AceComm provides lots of flexibility to it's host and mailer
  5263. services. This comes with a price. The learning curve. It takes time to
  5264. become familiar with the different setup menus and how they interact. There
  5265. is plenty help available from the author and other AceComm pioneers.
  5266.  
  5267. Lets take a look at the "Point Mailer Setup" menu.
  5268. This menu contains almost all the mailer service setup. The scheduler has it's
  5269. own menu. Directories for "Nodelist", "Mail In", "Mail Out", are in the
  5270. "Directories In Use" menu., The "Long Distance Detect" is in the "Phone
  5271. Number Modifiers" menu.
  5272.  
  5273. ╔═Point Mailer Setup══════════════════════════════════════════════════════════
  5274. ║═Request Files═══════════════════════════════════════════════════════════════
  5275. ║>Request       REQUEST.LST
  5276. ║ Files         MGP-SOFT.ZIP
  5277. ║ About         ABOUT.FIL
  5278. ║═Macros to run at:═══════════════════════════════════════════════════════════
  5279. ║ Program start <DispStr>^L^M[BWhi][Blu] Install on port %P  ^M Initializing M
  5280. ║ After Mail    <ChgDir>D:\MAIL <RunProg>QM toss <ChgDir>[DIR_START]
  5281. ║ Mail Only     <HostEcho>ON <DispStr>^MAceComm will be available later tonigh
  5282. ║═Boss Data Menus═════════════════════════════════════════════════════════════
  5283. ║ AceComm Support BBS
  5284. ║ Roberts
  5285. ║ Gren
  5286. ║
  5287. ║
  5288. ║═Sub Menus═══════════════════════════════════════════════════════════════════
  5289. ║ EMSI Data
  5290. ║ Passwords
  5291. ║ Options
  5292. ╚═══ Edit  Quit  Help ┤<>v^├══════════════════════════════════════════════════
  5293.  
  5294.  
  5295. Request Files
  5296. -------------
  5297.  
  5298. Request
  5299.  
  5300.    FILENAME    AceComm will look in this file for file requests.
  5301.                This file must contain full paths.
  5302.    Examples:   C:\ACE\FILES\ACE185A.ZIP
  5303.                C:\ACE\FILES\ACE185B.ZIP
  5304.  
  5305.  
  5306.  
  5307.  
  5308.  
  5309.  
  5310.        Page 86              AceComm (tm) v 1.85
  5311.  
  5312.  
  5313. Chapter 10  Point Mailer Setup
  5314.  
  5315.  
  5316.  
  5317. Files
  5318.  
  5319.    FILENAME    When this File Request comes in, "Files", AceComm will send
  5320.                FILENAME.
  5321.  
  5322. About
  5323.  
  5324.    FILENAME    This file will be sent after any file requests. This will
  5325.                typically be a short description file for your system.
  5326.  
  5327.  
  5328. Macros to run at:
  5329. -----------------
  5330.  
  5331. Program start
  5332.  
  5333.    This macro stack is run when AceComm is first started.
  5334.  
  5335.  
  5336. After Mail
  5337.  
  5338.    This macro stack is run when AceComm has just finished receiving mail.
  5339.  
  5340.  
  5341. Mail Only
  5342.  
  5343.    This macro stack is run when the AceComm scheduler is in a ",Mail" but not
  5344.    ",Host" event.  ",Mail" only events allow EMSI mail sessions, but no access
  5345.    to the "AutoAnswer Menu" macros.  This is not to say that AceComm does not
  5346.    answer in ",Mail" only events.  There is a separate "AutoAnswer Setup" menu
  5347.    for BBS callers.  The service defined in this menu are not allowed except
  5348.    when schedules are enables, and ",Host" is an attribute flag for the
  5349.    currently active schedule.
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.  
  5368.  
  5369.        Page 87              AceComm (tm) v 1.85
  5370.  
  5371.  
  5372. Chapter 10  Point Mailer Setup
  5373.  
  5374.  
  5375. Boss Data Menus
  5376. ----------
  5377.  
  5378. o Boss data is used for mail Poll, Send, Request functions from inside the menu
  5379.    system (manual).  Automated mail functions require a NODELIST file and
  5380.    NLIST.IDX file.
  5381.  
  5382.  
  5383.    AceComm contains 5 separate data areas for User defined "Boss node" mail
  5384.    systems to dial.
  5385.  
  5386.    Use these when you don't want to use a NODELIST file, or as the second
  5387.    example, the system isn't in any NODELIST anyway.
  5388.  
  5389.   ╔═Edit Data════════════════════════════════════════════╗
  5390.   ║> Boss Name  AceComm Support BBS                      ║
  5391.   ║  Boss Addr  1:114/35                                 ║
  5392.   ║ Boss Phone  1-602-846-2940                           ║
  5393.   ║   Boss Pwd  password                                 ║
  5394.   ║  Boss Baud  38400                                    ║
  5395.   ╚═══(Edit) Quit  Help ┤<>v^├═══════════════════════════╝
  5396.  
  5397.   ╔═Edit Data════════════════════════════════════════════╗
  5398.   ║> Boss Name  Roberts                                  ║
  5399.   ║  Boss Addr  1:123/123                                ║
  5400.   ║ Boss Phone  1-214-123-1234                           ║
  5401.   ║   Boss Pwd                                           ║
  5402.   ║  Boss Baud                                           ║
  5403.   ╚═══(Edit) Quit  Help ┤<>v^├═══════════════════════════╝
  5404.  
  5405.   See also <PollBoss> macro
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.        Page 88              AceComm (tm) v 1.85
  5429.  
  5430.  
  5431. Chapter 10  Point Mailer Setup
  5432.  
  5433.  
  5434.   ╔═EMSI Data════════════════════════════════════════════╗
  5435.   ║>Address     1:114/35                                 ║
  5436.   ║ Aka                                                  ║
  5437.   ║ Aka                                                  ║
  5438.   ║ SysName     AceComm Software Support                 ║
  5439.   ║   SysOp     Michael G Phelps                         ║
  5440.   ║    City     Phoenix, AZ                              ║
  5441.   ║   Phone     (602) 846-2940                           ║
  5442.   ║    Baud     38400                                    ║
  5443.   ║   Flags     V32b,CM,XA                               ║
  5444.   ╚═══(Edit) Quit  Help ┤<>v^├═══════════════════════════╝
  5445.  
  5446.  
  5447. EMSI Handshake Data
  5448.  
  5449.    The following data is presented to the remote mail system during EMSI
  5450.    handshaking.
  5451.  
  5452.    Address         1:114/35
  5453.  
  5454.    Aka             123/123
  5455.  
  5456.    Sys Name        AceComm Support
  5457.  
  5458.    City            Phoenix, AZ
  5459.  
  5460.    Operator        Michael Phelps
  5461.  
  5462.    Sys Phone       (602) 846-2940
  5463.  
  5464.    Baud            14.4
  5465.  
  5466.    Flags          v32b
  5467.  
  5468.    Password  --  Pre arranged between two systems.
  5469.  
  5470.    The following example will cause AceComm to fill in the EMSI data field for
  5471.    "password" with 'mailman' when the target system's address is 1:114/12.
  5472.  
  5473.                   Password 1:114/12 mailman
  5474.  
  5475.  
  5476.    ┌─Example: 1:114/12 mailman───────────────────────────
  5477.    │>   Password 1:114/35 acecomm
  5478.    │    Password 1:114/440 holdmail
  5479.    │    Password 1:114/12 mailman
  5480.    │    Password
  5481.  
  5482.  
  5483.  
  5484.  
  5485.  
  5486.  
  5487.        Page 89              AceComm (tm) v 1.85
  5488.  
  5489.  
  5490. Chapter 10  Point Mailer Setup
  5491.  
  5492.    │    Password
  5493.    └─── Edit  Quit  Help ┤<>v^├──────────────────────────
  5494.  
  5495.  
  5496. Options Menu
  5497.  
  5498. ╔═Options═══════════════════════════╗
  5499. ║>Min Scan           30             ║
  5500. ║ Max Scan           1200           ║
  5501. ║ Redials            2              ║
  5502. ║ Full Time Point    On             ║
  5503. ╚═══(Select) Quit ┤<>v^├════════════╝
  5504.  
  5505. Min Scan                Time between mail scans when mail exists
  5506.                         (seconds between dialing attempts)
  5507.  
  5508. Max Scan                Time between mail scans when last scan found no mail
  5509.                         (Seconds till we peak for mail)
  5510.  
  5511. Redials                 Times to re dial during a mail scan
  5512.                         Not to be confused with dialing attempts, the
  5513.                         re-dialer will dial "Redials" times before letting go
  5514.                         back to the main program. Where it will be "Min Scan"
  5515.                         time until the next dialing attempt.
  5516.  
  5517. Full Time Point         Allow point mail services when schedules are off
  5518.                         un-define long distance detect from inside "Phone
  5519.                         Number Modifiers" menu for long distance calls. Or
  5520.                         you have to enable schedule and have ",LD" and an
  5521.                         attribute to the currently active schedule.
  5522.  
  5523.  
  5524. The following menu is available from Terminal Area. <AutoAMenu_> is the macro
  5525. that runs this menu. The default key board has <AutoAMenu_> assigned to ALT M.
  5526.  
  5527. ╔═1:114/35, AceComm Software Support═══════════════════════════════════════╗
  5528. ║ BBS calls 0  Mail calls 0  Scan time 1200  Next scan 1199                ║
  5529. ╚═══(Poll/FReq) Attach  Menu  Scan_now  Toggle_scheds  Quit ┤<>v^├════════╝
  5530.      |          |        |     |         |
  5531.      |          |        |     |         Enable/disable Schedules
  5532.      |          |        |     |
  5533.      |          |        |     Force a new mail scan
  5534.      |          |        |
  5535.      |          |        This menu choice brings up the "Point Mailer Setup"
  5536.      |          |        menu discussed above.
  5537.      |          |
  5538.      |          |
  5539.      |          Bring up the sending mailer services menu
  5540.  
  5541.  
  5542.  
  5543.  
  5544.  
  5545.  
  5546.        Page 90              AceComm (tm) v 1.85
  5547.  
  5548.  
  5549. Chapter 10  Point Mailer Setup
  5550.  
  5551.      |
  5552.      Bring up the receiver mailer services menu
  5553.  
  5554.  
  5555.  
  5556.  
  5557. Mailer Systems Phone Directory (FidoNet Nodelist)
  5558. -----------------------------------------------
  5559. FidoNet Nodelist is a systems directory that most EMSI capable HOST systems
  5560. use.  AceComm can use a FidoNet Nodelist.  To use the FidoNet Nodelist, you
  5561. must first compile an INDEX file.  AceComm uses NLIST.IDX.  NLIST.IDX contains
  5562. a quick look up table for Zone:Net/Nodes in the FidoNet Nodelist.  The AceComm
  5563. package provides IDX.EXE as a utility to create the NLIST.IDX file.  NLIST.IDX
  5564. and the NODELIST are to be found inside of the PRM-data directory "NODELIST".
  5565.  
  5566.  
  5567. Automated Mail Services Requirements
  5568. ------------------------------------
  5569. Automated (event driven) mail services require a NLIST.IDX,NODELIST.nnn pair be
  5570. present in the NODELIST directory, or you may define Boss node data.  There are
  5571. 5 Boss data areas.
  5572.  
  5573. You need the "Full Time Point"flag turned on or the "Scheduler" to be in at
  5574. least ",Mail" mode, or both.  You need to understand the long distance
  5575. detection, and long distance phone number translation/filter.  These are
  5576. located in the "Phone Number Modifiers" menu.
  5577.  
  5578. When an Event Schedule declares ",Mail" as part of the event, AceComm will scan
  5579. the MAIL_OUT directory for *.FLO files.  FLO type files supported are:
  5580.  
  5581.     FLO  ; file attach
  5582.     CLO  ; continuous
  5583.     DLO  ; direct
  5584.     OUT  ; non archive version of above
  5585.     CUT
  5586.     DUT
  5587.     REQ  ; request
  5588.  
  5589. AceComm will begin looking in the Nodelist directory for a NLIST.IDX file and
  5590. associated NODELIST.nnn file.  If found, AceComm will look up the target
  5591. system, build a Fon.Record with the information, and begin dialing with intent
  5592. to send mail, file requests etc.  Any local systems will require a Dial filter
  5593. statement be defined so that AceComm can translate the long distance number (as
  5594. contained in the Nodelist) into a local one.
  5595.  
  5596.    The following dial statement filter "1-602-" from all phone numbers the
  5597.    string is found in.
  5598.                          Dial filter 1-602-
  5599.  
  5600.  
  5601.  
  5602.  
  5603.  
  5604.  
  5605.        Page 91              AceComm (tm) v 1.85
  5606.  
  5607.  
  5608. Chapter 10  Point Mailer Setup
  5609.  
  5610.    This is setup as "Translation" numbers from "Phone Number Modifier" menu.
  5611.  
  5612.  
  5613. Making File Requests
  5614. --------------------
  5615.  
  5616. File Requests .REQ files are considered mail files, and processed in the same
  5617. way.  During a ",Mail" event, or with the "Full time Point" flag.  Files
  5618. received during a file request are placed into the MAIL_IN directory.
  5619.  
  5620. Filenames contained inside of FLO files, with exception to REQ files are to be
  5621. sent out to the target system.  Filenames that are prefixed with a '#'
  5622. character are made ZERO length after sending.  Filenames prefixed with '^'
  5623. character are deleted upon successful send.
  5624.  
  5625. The following has been taken from the "Protocols" menus section.  Receive/Send
  5626. Protocols sections present step by step through File Request and File Attach.
  5627.  
  5628.  
  5629. Recv Mail / File Request
  5630.  
  5631.   "FileRequest" is a point mail function.
  5632.  
  5633. ╔═════════════════════════════════════════════════════════════════════════
  5634. ║>1:114/35
  5635. ║ Format=> ZONE:NET/NODE
  5636. ║═Boss Data═══════════════════════════════════════════════════════════════
  5637. ║  Boss Name               AceComm Support BBS
  5638. ║  Boss Addr               1:114/35
  5639. ║ Boss Phone               1-602-846-2940
  5640. ║   Boss Pwd               password
  5641. ║
  5642. ║
  5643. ║ c:\fil\NLIST.IDX
  5644. ║ c:\fil\nodelist.063
  5645. ╚═ Enter_address  Boss_call  Next_boss  Quit ┤<>v^├═══════════════════════
  5646.  
  5647.  This menu prompts the user for a ZONE:NET/NODE number of the system we want to
  5648.  call.  If any "Boss Data" is defined, AceComm allows toggle through any of
  5649.  the 5 "Boss Data" fields, and selecting "Boss_call". Otherwise AceComm will
  5650.  look up a node address from the FidoNet Nodelist. Notice the bottom of the
  5651.  menu above displays where AceComm has found it's custom Nodelist index file,
  5652.  and FidoNet Nodelist file. If these are in correct, you need to go into the
  5653.  Configuration area, "Directories" menu.
  5654.  
  5655.  Upon selecting either "Boss Data" or entering a node number, AceComm will
  5656.  present the following screen. AceComm will search for any passwords defined
  5657.  inside the "Point Mail" menu. Long distance phone numbers are translated
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.        Page 92              AceComm (tm) v 1.85
  5665.  
  5666.  
  5667. Chapter 10  Point Mailer Setup
  5668.  
  5669.  according with the "Translate" menu data.
  5670.  
  5671.  ╔════════════════════════════════════════════════════╗
  5672.  ║    System Name MGP_Programming_Services            ║
  5673.  ║           City Phoenix_AZ                          ║
  5674.  ║  Operator Name Michael_Phelps                      ║
  5675.  ║   Phone Number 1-602-846-2940                      ║
  5676.  ║      Baud Rate 9600                                ║
  5677.  ║          Flags V32                                 ║
  5678.  ║       Password                                     ║
  5679.  ╚═ File_Request  Human_call  Poll_for_Mail  Quit ════╝
  5680.  
  5681. At this point if the user selects "File_Request" , an input window will pop up
  5682. prompting for filenames.  "Human_call" will dial the phone number, but not
  5683. attempt any mail session.  "Poll_for_Mail" will allow a call, and mail session,
  5684. without having any mail to send.  See the <PollBoss>n macro.
  5685.  
  5686.  
  5687. Send Mail / File Attach
  5688.  
  5689.   This selection allows the user to send files to EMSI capable mailer
  5690.   software.
  5691.  
  5692.  
  5693.  
  5694.  
  5695.  
  5696.  
  5697.  
  5698.  
  5699.  
  5700.  
  5701.  
  5702.  
  5703.  
  5704.  
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.  
  5713.  
  5714.  
  5715.  
  5716.  
  5717.  
  5718.  
  5719.  
  5720.  
  5721.  
  5722.  
  5723.        Page 93              AceComm (tm) v 1.85
  5724. Chapter 11  File List/Utility Area
  5725.  
  5726. Chapter 11  File List/Utility Area
  5727.  
  5728.  
  5729.  
  5730. You can get into this area with the <FileList_> macro. The macro takes an
  5731. optional parameter.
  5732.    <FileList_>[DIR_DNLDS]
  5733.    <FileList_>C:\FILES
  5734.  
  5735.  ╔═D:\ACE═══════════════════════════════╗
  5736.  ║> 1_114.FON    26368   06/27/93 07:25 ║
  5737.  ║  ACE.ASM      8269    06/26/93 18:00 ║
  5738.  ║  ACE.CTL      13589   06/25/93 08:04 ║
  5739.  ║  ACE.EXE      196102  06/27/93 07:24 ║
  5740.  ║  ACE.FON      1600    06/27/93 04:13 ║
  5741.  ║  ACE.HLP      44572   06/27/93 07:09 ║
  5742.  ║  ACE.LOG      3694    06/27/93 07:29 ║
  5743.  ...
  5744.  ║  ACTL.ASM     101998  06/25/93 14:22 ║
  5745.  ║  Utility  New_Dir  Change_Drive      ║
  5746.  ╚═ Tag  Delete  Quit  Help ┤<>v^├══════╝
  5747.  
  5748. Utility
  5749. -------
  5750.   This selection brings up a sub-menu of pre-defined executable.  AceComm
  5751.   contains several sub-menus for this purpose.  Sub-menu selected is determined
  5752.   by the "highlighted" files's extension.  The %FN symbol is documented in
  5753.   MACRO.DOC.  %FN is an Expandable MACRO Function.  %FN argument to a MACRO
  5754.   from anywhere inside the "File Lister" menus is replaced with FULL PATH NAME
  5755.   for the current high lighted filename.
  5756.  
  5757.  ╔═C:\DOC═══════════════════════════════╗
  5758.  ║  A.SNA        1242    06/27/93 07:53 ║
  5759.  ║  ACE.BAK      117893  06/26/93 12:25 ║
  5760.  ║  ACE.CHA      2706    06/27/93 07:46 ║
  5761.  ║>╔═%FN = C:\DOC\ACE.DOC══════════════════════════════════
  5762.  ║ ║ <RunProgram> BB %FN
  5763.  ║ ║><RunProgram> LIST %FN
  5764.  ║ ║ <RunProgram> QEDIT %FN
  5765.  ║ ║ <RunProgram> GREP %PF %FN %PF
  5766.  ║ ║ <RunProgram> PATCH %FN
  5767.  ║ ╚═ Select  Edit  Quit ┤<>v^├════════════════════════════
  5768.  ║  COVER        213     06/25/93 16:22 ║
  5769.  ║  CREDIT.CRD   2918    06/25/93 15:30 ║
  5770.  ...
  5771.  ║  FILE_ID.DIZ  392     06/26/93 13:14 ║
  5772.  ║  Utility  New_Dir  Change_Drive      ║
  5773.  ╚═ Tag  Delete  Quit  Help ┤<>v^├══════╝
  5774.  
  5775.  
  5776.  
  5777.  
  5778.  
  5779.  
  5780.  
  5781.  
  5782.        Page 94              AceComm (tm) v 1.85
  5783.  
  5784.  
  5785. Chapter 11  File List/Utility Area
  5786.  
  5787. New_Dir
  5788. -------
  5789.   Allows changing directories.  AceComm changes directories right along with
  5790.   the display.  When you use AceComm's "Utils" Menu, work is done in the
  5791.   currently listed directory unless otherwise redirected via MACRO arguments or
  5792.   overriding external executable configurations.
  5793.  
  5794.   Notes: AceComm always returns to the starting directory after leaving the
  5795.          FileLister Area.
  5796.                     ╔═D:\ACE═══════════════╗
  5797.  ╔═D:\ACE═══════════║>>D:\ACE              ║
  5798.  ║> 1_114.FON    263║ >..                  ║
  5799.  ║  ACE.ASM      826║ >CAP                 ║
  5800.  ║  ACE.CTL      135║ >CVTFON              ║
  5801.  ║  ACE.EXE      196║ >FILES               ║
  5802.  ║  ACE.FON      160║ >FON                 ║
  5803.  ║  ACE.HLP      445║ >KTS                 ║
  5804.  ║  ACE.LOG      369║ >MAIL                ║
  5805.  ║  ACE.MAP      920║ >SCR                 ║
  5806.  ║  ACE.OBJ      271║ >SND                 ║
  5807.  ║  ACE.PRM      378║ >XTRA                ║
  5808.  ║  ACEBOX.INC   345║ >ZEN                 ║
  5809.  ║  ACEM         253║ >F                   ║
  5810.  ║  ACEORDER.FRM 588╚═ Select  Quit ┤<>v^├═╝
  5811.  ║  ACET.SCR     809     05/17/93 21:33 ║
  5812.  ...
  5813.  ║  ACTL.ASM     101998  06/25/93 14:22 ║
  5814.  ║  Utility  New_Dir  Change_Drive      ║
  5815.  ╚═ Tag  Delete  Quit   Help ┤<>v^├═════╝
  5816.  
  5817.  
  5818. Change Drive
  5819. ------------
  5820.   Allows listing another drive.
  5821.  ╔═D:\ACE═══════════╔══════════════════════╗
  5822.  ║> 1_114.FON    263║>A                    ║
  5823.  ║  ACE.ASM      826║ B                    ║
  5824.  ║  ACE.CTL      135║ C                    ║
  5825.  ║  ACE.EXE      196║ D                    ║
  5826.  ║  ACE.FON      160║ E                    ║
  5827.  ║  ACE.HLP      445╚═ Select  Quit ┤<>v^├═╝
  5828.  ║  ACE.LOG      3694    06/27/93 07:29 ║
  5829.  ...
  5830.  ║  ACTL.ASM     101998  06/25/93 14:22 ║
  5831.  ║  Utility  New_Dir  Change_Drive      ║
  5832.  ╚═ Tag  Delete  Quit  Help ┤<>v^├══════╝
  5833.  
  5834.  
  5835.  
  5836.  
  5837.  
  5838.  
  5839.  
  5840.  
  5841.        Page 95              AceComm (tm) v 1.85
  5842.  
  5843.  
  5844. Chapter 11  File List/Utility Area
  5845.  
  5846. Tagged files
  5847. ------------
  5848.   Tagged files are stored in the file "UPLDS.LST" when tagged from inside the
  5849.   <FileLister_> MACRO.  When tagged from any of AceComm's internal protocol
  5850.   sending units, tagged filenames are stored into a temporary file.  The
  5851.   temporary file is deleted after each use.  UPLDS.LST files are not deleted,
  5852.   but instead stored ready.
  5853.  
  5854.   AceComm will look for UPLDS.LST when any internal batch capable protocols are
  5855.   selected.  If found, AceComm will ask the user is sending the contents of
  5856.   UPLDS.LST is desired, if (Y)es, AceComm will attempt to send all filenames
  5857.   listed in the UPLDS.LST file, if (n)o, AceComm will present the the File
  5858.   Input' menu.
  5859.  
  5860.  ╔═D:\ACE═══════════════════════════════╗╔═UPLDS.LST════════════
  5861.  ║  1_114.FON    26368   06/27/93 07:25 ║║>D:\ACE\1_114.FON
  5862.  ║> ACE.ASM      8269    06/26/93 18:00 ║║
  5863.  ║  ACE.CTL      13589   06/25/93 08:04 ║║
  5864.  ║  ACE.EXE      196102  06/27/93 07:24 ║║
  5865.  ║  ACE.FON      1600    06/27/93 04:13 ║║
  5866.  ║  ACE.HLP      44572   06/27/93 07:09 ║║
  5867.  ║  ACE_MAIL.CFG 430     06/22/93 14:23 ║║
  5868.  ...
  5869.  ║  ACTL         591     06/22/93 14:08 ║║
  5870.  ║  ACTL.ASM     101998  06/25/93 14:22 ║║
  5871.  ║  Utility  New_Dir  Change_Drive      ║╚══════════════════════
  5872.  ╚═│Tag│ Delete  Quit  Help ┤<>v^├══════╝
  5873.  
  5874.  
  5875. Delete
  5876. ------
  5877.   Delete option presents a full path spec for the high lighted filename,
  5878.   prompting confirmation before deletion.
  5879.  ╔═D:\ACE═══════════════════════════════╗
  5880.  ║  1_114.FON    26368   06/27/93 07:25 ║
  5881.  ║>╔═══════════════════╗ 06/27/93 07:31 ║
  5882.  ║ ║ D:\ACE\A.SNA      ║ 06/26/93 18:00 ║
  5883.  ║ ║ Delete this file? ║ 06/27/93 07:31 ║
  5884.  ║ ║>(Y)es/(n)o?:      ║ 06/25/93 08:04 ║
  5885.  ║ ╚═══════════════════╝ 06/27/93 07:24 ║
  5886.  ║  ACE.FON      1600    06/27/93 04:13 ║
  5887.  ║  ACE.HLP      44572   06/27/93 07:09 ║
  5888.  ║  ACE_DEF.KBD  11120   06/27/93 07:29 ║
  5889.  ...
  5890.  ║  ACE_MAIL.CFG 430     06/22/93 14:23 ║
  5891.  ║  Utility  New_Dir  Change_Drive      ║
  5892.  ╚═ Tag  Delete  Quit  Help ┤<>v^├══════╝
  5893.  
  5894.  
  5895.  
  5896.  
  5897.  
  5898.  
  5899.  
  5900.        Page 96              AceComm (tm) v 1.85
  5901.  
  5902.  
  5903. Chapter 11  File List/Utility Area
  5904.  
  5905.  
  5906.  
  5907.  
  5908.  
  5909.  
  5910.  
  5911.  
  5912.  
  5913.  
  5914.  
  5915.  
  5916.  
  5917.  
  5918.  
  5919.  
  5920.  
  5921.  
  5922.  
  5923.  
  5924.  
  5925.  
  5926.  
  5927.  
  5928.  
  5929.  
  5930.  
  5931.  
  5932.  
  5933.  
  5934.  
  5935.  
  5936.  
  5937.  
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.  
  5949.  
  5950.  
  5951.  
  5952.  
  5953.  
  5954.  
  5955.  
  5956.  
  5957.  
  5958.  
  5959.        Page 97              AceComm (tm) v 1.85
  5960. Chapter 12  ACECOMM DATA FILES
  5961.  
  5962. Chapter 12  ACECOMM DATA FILES
  5963.  
  5964.  
  5965.  
  5966.    ACE.PRM
  5967.  
  5968. ACE.PRM is a binary file which contains all of AceComm's memory, so to speak.
  5969. When AceComm is started it reads the ACE.PRM file.  All your serial data, modem
  5970. data, the keyboard assignments, menu-usage, customizing and so on is stored in
  5971. ACE.PRM.  PRM-data Area edits the ACE.PRM data, and when AutoSave is "ON", all
  5972. data is saved each time you leave PRM-data Area.  When AceComm is terminated,
  5973.  
  5974.  
  5975.  
  5976.  
  5977.  
  5978.  
  5979.  
  5980.  
  5981.  
  5982.  
  5983.  
  5984.  
  5985.  
  5986.  
  5987.  
  5988.  
  5989.  
  5990.  
  5991.  
  5992.  
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.  
  6002.  
  6003.  
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013.  
  6014.  
  6015.  
  6016.  
  6017.  
  6018.        Page 98              AceComm (tm) v 1.85
  6019.  
  6020. the PRM-data is saved to ACE.PRM.
  6021.  
  6022.  
  6023.    ACE.CTL
  6024.  
  6025. ACE.PRM can be rebuilt using the ACTL.EXE utility.  ACTL.EXE reads and formats
  6026. a .CTL file into ACE.PRM.  A default .CTL file comes with the AceComm package.
  6027. The default filename is ACE.CTL.  Any filename is valid with the
  6028. .CTL extension.  DPRM.EXE produces writes a new ACE.CTL file with updated
  6029. setup configuration.
  6030.  
  6031.  
  6032.    .KTS/.ASC/.BIN files
  6033.  
  6034. "Key Translation Sequence" files are used when you want a key press to be
  6035. translated into a sequence of characters.  A good example of KTS is in the
  6036. ANSIBBS.KTS file.  Here, keys such as Up Arrow are defined to send an ansi
  6037. escape sequence that the HOST'S video can read, and bounce back, decrementing
  6038. the cursor position by 1.
  6039.  
  6040. A utility KTS.EXE is provided with the AceComm package, which allows you the
  6041. user to compile .ASC files into .KTS file.
  6042.  
  6043. You can look at the included .ASC files, that come inside KTS_SFX.EXE, as an
  6044. example to work from.  The ANSI.ASC file was compiled by KTS.EXE into
  6045. ANSI.BIN.  ANSI.BIN is exactly the same as ANSI.KTS.  The .BIN extensions is
  6046. used so that a working .KTS file is not overwritten.  You need to rename .BIN
  6047. files to .KTS when ready for use.
  6048.  
  6049. Notes: Keys assigned KTS are processed only if not defined in KBD.  When a key
  6050.        is assigned to a MACRO(s), the MACRO(s) take priority and are
  6051.        processed.  Do not assign MACRO(s) to key-presses you want to KTS.
  6052.  
  6053. .KTS has it's directory definition optionally defined inside PRM-data area.
  6054.  
  6055.  
  6056.    .KBD
  6057.  
  6058. KBD files give the user ability to keep more than one keyboard layout for
  6059. AceComm operations.
  6060.  
  6061. KBD KeyBoarD files contain the MACRO assignments for the keyboard.  When
  6062. AceComm is first installed, the file "ACE_DEF.KBD" is used as a default
  6063. keyboard (KBD).  When AceComm is started, it reads the "current" KBD file.
  6064. Current KBD file is the default ("ACE_DEF.KBD" or the last KBD Loaded from
  6065. inside the PRM-data menu area.
  6066.  
  6067. When you "Load" a KBD file from inside PRM-data area, The KBD file becomes
  6068. "current".  This means that any changes you make to the key definitions are
  6069. saved to the "current" KBD file.  Updating the "current" KBD file is done
  6070. automatically when leaving PRM-data area when "AutoSave" is "ON" (default).
  6071. When "AutoSave" is "OFF" you need to manually select the "Save" option from the
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.        Page 99              AceComm (tm) v 1.85
  6079.  
  6080.  
  6081. Chapter 12  ACECOMM DATA FILES
  6082.  
  6083.            KBD files
  6084.  
  6085. main PRM-data menu.  Do not confuse "Save" with "Write".  "Write" is an option
  6086. found inside the "KeyBoarD MACRO Assignments" menu.  "Write does not save
  6087. changes to the "current" KBD file, but prompts the user for a filename, and
  6088. creates or overwrites a new or existing KBD file.  Then "Write" re-loads the
  6089. "current" KBD file.
  6090.  
  6091. KBD files are also used with Fon.Records.  The AceComm package comes with a
  6092. "CIS.KBD" file example.  The ACE.FON file, also provided with the AceComm
  6093. package, contains a record for CIS (local Phoenix).  This Fon.Record (CIS) has
  6094. defined as a KBD file, "CIS.KBD".  When dialing a Fon.Record that contains a
  6095. KBD file definition, AceComm will upon successful Dial/Connect, load the KBD
  6096. file associated with the Fon.Record.  This custom KBD file is valid for the
  6097. time that AceComm detects CARRIER (DCD), or the user loads another KBD file
  6098. from inside the PRM-data area.  When AceComm detects that the Dial/Connect call
  6099. is over, (DCD drops),
  6100.  
  6101.   AceComm will:
  6102.  
  6103.                Write the Fon.Record's KBD file, saving any changes that may
  6104.                have been made to it while on line.
  6105.  
  6106.                Re-load the KBD file that was in affect before the connection
  6107.                was established to system that had a KBD file associated with
  6108.                it's Fon.Record.
  6109.  
  6110. KBD files may be associated to a Fon.Record from inside the telephone directory
  6111. area, "Edit" option.
  6112.  
  6113.  
  6114.    .REQ/FLO
  6115.  
  6116. Filenames created with ".REQ" extensions are used when making File Requests on
  6117. EMSI FIDONET style systems.  REQ files are a list of <CR> <LF> terminated
  6118. filenames.  This REQ file is sent to the system the File Request is being made
  6119. on, the system will send from the list.
  6120.  
  6121. Filenames created with ".FLO" extensions are used for Attaching (sending) files
  6122. to EMSI FIDONET style systems.  FLO files are a list of <CR> <LF> terminated
  6123. filenames.  AceComm sends from the list (LISTFILE).
  6124.  
  6125. .REQ/FLO has it's directory definition optionally defined inside PRM-data area.
  6126.  
  6127.  
  6128.    .LST
  6129.  
  6130. AceComm creates LISTFILES with .LST extensions.  A .LST extended LISTFILE is
  6131.  
  6132.  
  6133.  
  6134.  
  6135.  
  6136.  
  6137.        Page 100              AceComm (tm) v 1.85
  6138.  
  6139.  
  6140. Chapter 12  ACECOMM DATA FILES
  6141.  
  6142.            REQ/FLO,LST,SCR,FON files
  6143.  
  6144. created from inside the "FileLister" (<FileLister_> macro) area.  Filenames
  6145. "Tagged" from inside "FileLister" are stored inside a file "UPLDS.LST".
  6146. AceComm's internal batch protocols will send from "UPLDS.LST" by default, you
  6147. do have the option of creating another LISTFILE, or entering filenames
  6148. manually.
  6149.  
  6150.  
  6151.    .SCR
  6152.  
  6153. AceComm forces ".SCR" file extensions onto script files.  Script files may be
  6154. generated automatically using AceComm's AutoScriptGen (Tm).  Script files may
  6155. be loaded from the terminal area, or used as AceComm's only argument when
  6156. starting AceComm.  Script files may be associated with
  6157.  
  6158. Fon.Records from inside "Edit" option.  Script files associated with a
  6159. Fon.Record are:
  6160.  
  6161. Upon successful Dial/Connect AceComm creates an "Event" just prior to exiting
  6162. back to terminal Area.  The "Event" is to run the Script file associated with
  6163. the Fon.Record.  Typically, this Script file will contain some auto log on
  6164. MACROS.  The Script plays out, end of "Event"
  6165.  
  6166. .SCR has it's directory definition optionally defined inside PRM-data area.
  6167.  
  6168.  
  6169.    .FON
  6170.  
  6171. AceComm uses a binary .FON file for storing it's telephone directory records.
  6172. Each record contains data specific to the system.  FON files must be edited
  6173. inside AceComm, using The Edit menu.
  6174.  
  6175. Telephone directory files are forced the ".FON" file extensions.  All
  6176. Fon.Records are stored inside of FON files.  AceComm FON files can hold up to
  6177. 1000 records each.  AceComm allows unlimited FON files.  Selection of FON files
  6178. is made available from inside the Fon.List area using "Fon_Files" option.
  6179.  
  6180. .FON has it's directory definition optionally defined inside PRM-data area.
  6181.  
  6182.  
  6183.  
  6184.  
  6185.  
  6186.  
  6187.  
  6188.  
  6189.  
  6190.  
  6191.  
  6192.  
  6193.  
  6194.  
  6195.  
  6196.        Page 101              AceComm (tm) v 1.85
  6197. Chapter 13  Mouse Support
  6198.  
  6199. Chapter 13  Mouse Support
  6200.  
  6201.  
  6202.  
  6203. Support for a pointer device has been implemented into AceComm using the
  6204. Microsoft Mouse Driver functions.  Your Microsoft compatible mouse should work
  6205. with AceComm.
  6206.  
  6207. Mouse in Terminal Area
  6208.  
  6209. o Pressing the left mouse button with the cursor over blank space sends <CR>.
  6210.  
  6211. o Pressing the left mouse button with the cursor over a character sends the
  6212.   character.
  6213.  
  6214. o Double clicking brings up the TopBar menu.
  6215.  
  6216. Mouse with Menus
  6217.  
  6218.    To move the vertical highlight bar in the menus, press the left mouse button
  6219.    and drag it along, the cursor will follow.  Selections can then be made from
  6220.    the lateral selector bar by highlighting the first character and pressing
  6221.    the left mouse button.
  6222.  
  6223.  
  6224.  
  6225.  
  6226.  
  6227.  
  6228.  
  6229.  
  6230.  
  6231.  
  6232.  
  6233.  
  6234.  
  6235.  
  6236.  
  6237.  
  6238.  
  6239.  
  6240.  
  6241.  
  6242.  
  6243.  
  6244.  
  6245.  
  6246.  
  6247.  
  6248.  
  6249.  
  6250.  
  6251.  
  6252.  
  6253.  
  6254.  
  6255.        Page 102              AceComm (tm) v 1.85
  6256. Chapter 14  AceComm Macro Language
  6257.  
  6258. Chapter 14  AceComm Macro Language
  6259.  
  6260.  
  6261. Reference to characters such as carriage return, space, escape, etc.  are made
  6262. in this document.  Reference to a character is made in the following manner.
  6263. <CR> <SP> where <CR> refers to a carriage return, and <SP> refers to a space
  6264. character.  Macros are bounded by the same <> brackets as character reference.
  6265. Character references are not macros.  A complete macro listing follows this
  6266. chapter.
  6267.  
  6268.  
  6269.  
  6270. o Macros are directives bounded inside of angle brackets < >
  6271.  
  6272. o Macros must have a SPACE character in front of the '<' left bracket when
  6273.     stacking.
  6274.  
  6275.  <ChgDir>[DIR_MAIL] <RunProg>OFFLINE <ChgDir>[DIR_START]
  6276.                    |                 |
  6277.                    |_________________|
  6278.                    |
  6279.                    Leading space
  6280.  
  6281. o Macros may be any combination of CaSe
  6282.  
  6283.  <RunProg> jmodem
  6284.  <runprog> jmodem
  6285.  
  6286.  
  6287. o The Macro Processor supports "Macro Stacking".  Macro Stacking means multiple
  6288.   Macros per line
  6289.  
  6290.  <SendStr>u z ACE0601.ARJ^M <SendZmo>files\ace0601.arj
  6291.  
  6292.  <SendStr>u z ACE0601.ARJ^M <RunProg>DSZ sz -m files\ace0601.arj
  6293.  
  6294.  <SetDTR> ON <SendStr>ATDT846-2940^M <WaitStr>CONNECT <SendStr>^[^[
  6295.  
  6296.  
  6297. o MACRO DATA PARAMETERS are bounded inside of square brackets [ ]
  6298.  
  6299. o MACRO DATA PARAMETERS need not have a <SP> character in front of them
  6300.  
  6301. o MACRO DATA PARAMETERS must be upper CASE
  6302.  
  6303.  <SendStr>[USER_NAME]^MY^M[FON_PWD]
  6304.           |          |    |
  6305.           |          |    Data Param (Fon.Record password field)
  6306.           |          |
  6307.           |          ^M translates into a <CR> (carriage return)
  6308.  
  6309.  
  6310.  
  6311.  
  6312.  
  6313.  
  6314.        Page 103              AceComm (tm) v 1.85
  6315.  
  6316.  
  6317. Chapter 14  AceComm Macro Language
  6318.  
  6319.           |
  6320.           Data Param (IEMSI user name field)
  6321.  
  6322.  <SendStr>[USER_NAME]^M~[PASSWORD]^M
  6323.  |        |          | |  |
  6324.  |        |          | |  IEMSI password field
  6325.  |        |          | |
  6326.  |        |          | One second delay (~ = second delay)
  6327.  MACRO    |          |
  6328.           |          Control character representation for <CR>
  6329.           |
  6330.           MACRO DATA PARAMETER (IEMSI data)
  6331.  
  6332.  
  6333. o MACRO FUNCTION PARAMETERS are prefixed with a % character
  6334.  
  6335.  <SendZmo> %PF
  6336.   |        |
  6337.   |        MACRO FUNCTION PARAMETER (prompt for filename)
  6338.   |
  6339.   Internal Zmodem sending unit
  6340.  
  6341.  <RunProg>dsz port %P speed %B sz %PF %WK <SendStr>^M
  6342.                       |        |     |   |
  6343.                       |        |     |   |
  6344.                       |        |     |   MACRO FUNCTION PARAM
  6345.                       |        |     |   (wait for key press)
  6346.                       |        |     |
  6347.                       |        |     MACRO FUNCTION PARAM
  6348.                       |        |     (prompt for filename)
  6349.                       |        |
  6350.                       |        MACRO FUNCTION PARAM
  6351.                       |        (insert ascii baud)
  6352.                       |
  6353.                       MACRO FUNCTION PARAM
  6354.                       (insert ascii port)
  6355.  
  6356.  
  6357.  
  6358. Please submit all macro suggestions to:
  6359. a)  MSG to Michael Phelps on the AceComm Support BBS
  6360. b)  MSG to Michael Phelps on Compuserve UID 75120,3306
  6361.  
  6362.  
  6363.  
  6364.  
  6365.  
  6366.  
  6367.  
  6368.  
  6369.  
  6370.  
  6371.  
  6372.  
  6373.        Page 104              AceComm (tm) v 1.85
  6374. Chapter 15  Macros list
  6375.  
  6376. Chapter 15  Macros list
  6377.  
  6378.  
  6379.  
  6380.  
  6381. LUI MACROS require local user input, and so are not suited to un-attended
  6382. scripts.  LUI MACROS contain a '_' underscore as the last character inside the
  6383. brackets.
  6384.  
  6385. <AutoAMenu_>
  6386.  
  6387.    Bring up a quick "Point Mail" / "Auto Answer" service menu. This for those
  6388.    using the scheduler and automated host modes.
  6389.  
  6390.  
  6391. <AutoScrGen_>
  6392.  
  6393.    Toggle AutoScrGen(tm) mode
  6394.  
  6395.    Toggle AutoScript Generation mode On/Off.  When "On" an extended status line
  6396.    will appear at the bottom of the TERMINAL screen.  At the far left of the
  6397.    extended status line will be the phrase "AutoScriptGen"
  6398.  
  6399.  
  6400. <ScrollBack_>
  6401.  
  6402.    Menu Area
  6403.    Enter Back Buffer Screen Area
  6404.  
  6405.    The "Scroll Back Buffer" contains the last n lines of display that scrolled
  6406.    off the TERMINAL screen.  <ScrollBack_> has a status line of it's own.  The
  6407.    status line contains such information as current line position into the
  6408.    buffer, total lines buffered, and some of the navigational keys are
  6409.    displayed.
  6410.  
  6411.  
  6412. <CaptureFile_>
  6413.  
  6414.    Toggle Capture File
  6415.    Prompts for filename
  6416.  
  6417.    Capture will also prompt for append or overwrite.  Capture does absolutely
  6418.    NO filtering of any kind.  All data is recorded to file "as it comes in the
  6419.    port".  The AceComm package comes with separate utilities which can strip
  6420.    video control codes from files.
  6421.  
  6422.    See also <OpenCapture> filename
  6423.             <CloseCapture>
  6424.  
  6425.  
  6426.  
  6427.  
  6428.  
  6429.  
  6430.  
  6431.  
  6432.        Page 105              AceComm (tm) v 1.85
  6433.  
  6434.  
  6435. Chapter 15  Macros list
  6436.  
  6437.            Local User Input (LUI) Functions
  6438.  
  6439. <DOSShell_>
  6440.  
  6441.    Enter Shell to Command Processor/ Operating System
  6442.  
  6443.    In most cases "Drop to DOS", if your DOS compatible operating system places
  6444.    it's name in the environment where AceComm can find it.  "Shell" is not hard
  6445.    wired to COMMAND.COM but the COMMAND PROCESSOR as found in the environmental
  6446.    data area.
  6447.  
  6448.    Notes: When SWAP is "ON", the serial port is effectively disabled during the
  6449.           shell.  When SWAP is "OFF" the serial port remains active and any
  6450.           incoming data is handled properly, unless the receive buffer wraps
  6451.           around.
  6452.  
  6453.  
  6454. <FileReq_>
  6455.    Menu driven EMSI file request function.
  6456.  
  6457.  
  6458. <PhoneList_>
  6459.  
  6460.    Menu Area
  6461.    Enter .FON List / Dialer
  6462.  
  6463.    Dial/.FON directory area.  While AceComm allows manual dialing from inside
  6464.    the TERMINAL area, it most convenient to dial from a record contained in one
  6465.    of the .FON files available for use from the DIAL area.
  6466.  
  6467.  
  6468. <FileList_>
  6469.  
  6470.    Menu Area
  6471.    Enter File Lister
  6472.  
  6473.    Files lister inside AceComm provides a basic directory list function capable
  6474.    of changing directories and drives.  File-marking, deletion, selection for
  6475.    appropriate file-utility, etc.  LISTFILES may be created.  UPLDS.LST is a
  6476.    file created by the Tag feature inside the File Lister Area.  files tagged
  6477.    will be listed inside UPLDS.LST as CR LF terminated strings.  When selecting
  6478.    any of AceComm's internal batch capable sending protocols, AceComm will
  6479.    check for the existent of the file UPLDS.LST and allow sending from the
  6480.    LISTFILE if desired.
  6481.  
  6482.  
  6483. <MdmHangUp_>
  6484.  
  6485.  
  6486.  
  6487.  
  6488.  
  6489.  
  6490.  
  6491.        Page 106              AceComm (tm) v 1.85
  6492.  
  6493.  
  6494. Chapter 15  Macros list
  6495.  
  6496.            Local User Input (LUI) Functions (continued)
  6497.  
  6498.    Prompts Yes/no before,
  6499.    Sends PRM-data MDM_HANGUP string to modem.  Waits 1/2 second, then drops DTR
  6500.    for 1 second.
  6501.  
  6502. See also    <MdmHangUp> (no Yes/no prompt, good in scripts)
  6503.  
  6504.  
  6505. <PrmData_>
  6506.  
  6507.    Menu Area
  6508.    Enter PRM-data Menu Area (Configuration Area)
  6509.  
  6510.    Notes: When AutoSave is "ON", all data changed is automatically saved when
  6511.           exiting the PRM-data area.
  6512.  
  6513.  
  6514. <RProtocols_>
  6515.  
  6516.    Menu Area
  6517.    Enter Receiver Protocols Area menu
  6518.  
  6519.  
  6520. <RunScript_>
  6521.  
  6522.    List .SCR directory, Allow selection, Run selected .SCR file
  6523.  
  6524.    Lists the PRM-data .SCR directory Allows selection of a .SCR file for
  6525.    immediate execution.
  6526.  
  6527.    Notes: AceComm allows .SCR file as an argument when started which
  6528.           immediately executes the script.
  6529.  
  6530.  
  6531. <ScrnDump_>
  6532.  
  6533.    Menu Area
  6534.    Take Screen Snapshot
  6535.  
  6536.    Create a "SnapShot" of the current screen minus any status lines active.
  6537.    Prompts for a filename.  Filenames always will have the .SNA extension.
  6538.    AceComm can detect and will strip away filename extensions provided by the
  6539.    user when they do not match that of the function.  This command is available
  6540.    from most ALT POP UP REFERENCE areas.
  6541.  
  6542.  
  6543. <ScrnTag_>
  6544.  
  6545.  
  6546.  
  6547.  
  6548.  
  6549.  
  6550.        Page 107              AceComm (tm) v 1.85
  6551.  
  6552.  
  6553. Chapter 15  Macros list
  6554.  
  6555.            Local User Input (LUI) Functions (continued)
  6556.  
  6557.  
  6558.    Menu Area
  6559.    Enter Screen Tagger Screen Area
  6560.  
  6561.    Tagger will allow tagging to the first SPACE_CHAR or press RIGHT-ARROW
  6562.    Tagger tags the entire line of text.  Tagger has it's own status line, and a
  6563.    block cursor will appear inside of the Tagger mode.  Tagged items will be
  6564.    assigned to the next available SHIFT-Fn key.
  6565.  
  6566.    Tagger pops up the SHIFT-Fn key window and displays each tagged item, as
  6567.    they are tagged.  Tagger is most handy for grabbing filenames for download
  6568.    off a BBS screen.  SHIFT-Fn key fires the tagged item back when ready.  This
  6569.    command is available from most ALT POP UP REFERENCE areas.
  6570.  
  6571.  
  6572. <SProtocols_>
  6573.  
  6574.    Menu Area
  6575.    Enter Sender Protocols Area
  6576.  
  6577.  
  6578. <KeyRef_>
  6579.  
  6580.    Bring up Pop up Reference The key press assigned this macro is always
  6581.    displayed on the right side of the status line.
  6582.  
  6583.  
  6584. <TopBar>
  6585.  
  6586.    Activate the menu bar at top of screen
  6587.  
  6588.    The key press assigned this macro is always displayed on the right side of
  6589.    the status line.
  6590.    "Top Bar" menu can also be brought up inside the terminal area by double
  6591.    clicking the left mouse button.
  6592.  
  6593. The following macros can be used to call individual menus otherwise choices
  6594. from the TopBar single line menu
  6595.  
  6596.  
  6597. <FileMenu>
  6598.  
  6599.    The TopBar File menu
  6600.  
  6601.  
  6602. <HelpMenu>
  6603.  
  6604.  
  6605.  
  6606.  
  6607.  
  6608.  
  6609.        Page 108              AceComm (tm) v 1.85
  6610.  
  6611.  
  6612. Chapter 15  Macros list
  6613.  
  6614.            Local User Input (LUI) Functions (continued)
  6615.  
  6616.  
  6617.    The TopBar Help menu
  6618.  
  6619.    The key press assigned this macro is always displayed on the right side of
  6620.    the status line.
  6621.  
  6622.  
  6623. <Users>
  6624.  
  6625.    The TopBar Users menu
  6626.  
  6627.    This is a menu that lists and allows menu selection for the User menus.
  6628.    (User1 - User5)
  6629.  
  6630.  
  6631. <PhoneMenu>
  6632.  
  6633.    Calls the <FonListDialer_> macro
  6634.  
  6635.  
  6636. <SetupMenu>
  6637.  
  6638.    Calls the <PrmDataMenus_> macro
  6639.  
  6640.  
  6641. <XfrMenu>
  6642.  
  6643.    The TopBar Transfer menu
  6644.  
  6645. <User>n
  6646.  
  6647. The following individual User menus can be brought up by themselves.
  6648. Otherwise they are selectable from inside the <Users> menu.
  6649. The macro takes a parameter 1 - 5
  6650.  
  6651. <User>1
  6652.  
  6653.    This macro brings up User menu # 1.
  6654. ...
  6655.  
  6656. <User>5
  6657.  
  6658.    This macro brings up User menu # 5.
  6659.  
  6660.  
  6661.  
  6662.  
  6663.  
  6664.  
  6665.  
  6666.  
  6667.  
  6668.        Page 109              AceComm (tm) v 1.85
  6669.  
  6670.  
  6671. Chapter 15  Macros list
  6672.  
  6673.            Character I/O Functions
  6674.  
  6675.  
  6676.  
  6677.   ┌─────────────────────────────────────────────────────────────┐
  6678.   │ Many macros are3 way toggles. Where no parameter toggles.   │
  6679.   │                                                             │
  6680.   │       <AutoAnswer>ON     ; Enable                           │
  6681.   │       <AutoAnswer>OFF    ; Disable                          │
  6682.   │       <AutoAnswer>       ; Toggle                           │
  6683.   └─────────────────────────────────────────────────────────────┘
  6684.  
  6685.  
  6686. --------------------
  6687. I/O Function Toggles
  6688. --------------------
  6689.  
  6690. <AutoAnswer>
  6691.  
  6692.    <AutoAnswer>ON     ; Enable
  6693.    <AutoAnswer>OFF    ; Disable
  6694.    <AutoAnswer>       ; Toggle
  6695.  
  6696.    PRM-data MDM_HOST_INIT is sent to the modem when hostmode flag is toggle
  6697.    "ON".  PRM-data MDM_INIT is sent to the modem when hostmode flag is toggled
  6698.    "OFF".  AceComm begins responding to the RI bit SET, and will send the
  6699.    MDM_ANSWER string to the modem when RI BIT becomes asserted.  Upon
  6700.    Answer/Connect, AceComm attempts to match the modem response to strings
  6701.    defined in the Auto Answer Setup menu.  The appropriate macro stack will
  6702.    then be run.  AceComm stores the actual connect speed for use with the %C
  6703.    macro parameter.  %B represents the port rate, %C represents the connect
  6704.    speed as reported by the modem.
  6705.  
  6706.    If you are using <AutoAnswer> alone, without any host script or host
  6707.    software, then be sure and also use <HostEcho>ON.  If you want to act as a
  6708.    host with characters being bounced back to the caller.
  6709.  
  6710.    Notes: Auto Answer is also terminated whenever the user dials out from the
  6711.           FON LIST MENU AREA.  If automated auto answer is being used by way of
  6712.           the scheduler, then auto answer mode will be re-entered as soon as
  6713.           AceComm detects carrier drop.
  6714.  
  6715.    See also   Auto Answer Setup menu
  6716.  
  6717.  
  6718. <DoorWayMode>
  6719.  
  6720.    <DoorWayMode>ON     ; Enable
  6721.  
  6722.  
  6723.  
  6724.  
  6725.  
  6726.  
  6727.        Page 110              AceComm (tm) v 1.85
  6728.  
  6729.  
  6730. Chapter 15  Macros list
  6731.  
  6732.            Character I/O Functions (continued)
  6733.  
  6734.    <DoorWayMode>OFF    ; Disable
  6735.    <DoorWayMode>       ; Toggle
  6736.  
  6737.    Toggle doorway mode.  Traps the key press on entry, whatever key press you
  6738.    assign <DoorWayMode> to, is the only way back out.  Doorway sends all key
  6739.    presses to the modem in their RAW 'un-cooked' form.  Non extended key
  6740.    presses are send LOW BYTE ONLY.  Extended key presses are sent LOW BYTE,
  6741.    HIGH BYTE.
  6742.  
  6743.    Notes: Pressing CONTROL BREAK will always end AceComm.  CONTROL BREAK is a
  6744.          back door to the <EndAceComm> macro.  When you exit the program by
  6745.          pressing CONTROL BREAK, all data is saved as usual, and program
  6746.          cleanup is as it would be using the <EndAceComm> macro.
  6747.  
  6748.  
  6749. <HostEcho>
  6750.  
  6751.    <HostEcho>ON     ; Enable
  6752.    <HostEcho>OFF    ; Disable
  6753.    <HostEcho>       ; Toggle
  6754.  
  6755.    Toggle Host echo mode.  This macro emulates HostMode's ECHO capability.  It
  6756.    does not answer the phone. Use <AutoAnswer>On to have AceComm answer.
  6757.  
  6758.    Host echo means that characters typed locally will be displayed both local
  6759.    and sent to the modem.
  6760.  
  6761.    Host echo will also translate <CR> into <CR><LF> pairs and <BS> into
  6762.    <BS><SP><BS>.
  6763.  
  6764.  
  6765. <LocalEcho>
  6766.  
  6767.    <LocalEcho>ON     ; Enable
  6768.    <LocalEcho>OFF    ; Disable
  6769.    <LocalEcho>       ; Toggle
  6770.  
  6771.    Toggle local character echo.  Local key-presses will be echoed to the
  6772.    screen.  (same effect as sending "ATE1^M" to the modem)
  6773.    If you use <LocalEcho> be sure your modem is set up with echo off.
  6774.    To turn the modem echo off   ATE0
  6775.  
  6776.  
  6777. -------------------------------------
  6778. I/O Flags Toggles internal to AceComm
  6779. -------------------------------------
  6780.  
  6781.  
  6782.  
  6783.  
  6784.  
  6785.  
  6786.        Page 111              AceComm (tm) v 1.85
  6787.  
  6788.  
  6789. Chapter 15  Macros list
  6790.  
  6791.            Character I/O Functions (continued)
  6792.  
  6793.  
  6794. <BitStrip>
  6795.  
  6796.    <BitStrip> on
  6797.    <BitStrip> off
  6798.    <BitStrip>
  6799.  
  6800.    AceComm going to strip high bit from ascii characters (above 127d)
  6801.  
  6802.  
  6803. <CTS>
  6804.  
  6805.    <CTS> on
  6806.    <CTS> off
  6807.    <CTS>
  6808.  
  6809.    AceComm uses CTS/RTS hardware handshaking.
  6810.  
  6811.  
  6812. <XON>
  6813.  
  6814.    <XON> on
  6815.    <XON> off
  6816.    <XON>
  6817.  
  6818.    AceComm uses XON/XOFF software handshaking
  6819.  
  6820. ----------
  6821. I/O Modem
  6822. ----------
  6823.  
  6824.  
  6825. <GetDCD>
  6826.  
  6827.    Returns 0 or 1 current carrier detect signal
  6828. :DIAL
  6829.    ...
  6830.    <GetDCD>
  6831.    <if>1 <goto>CONNECT
  6832.          <goto>DIAL
  6833.    ...
  6834. :CONNECT
  6835.  
  6836.  
  6837. <MdmHangUp>
  6838.  
  6839.  
  6840.  
  6841.  
  6842.  
  6843.  
  6844.  
  6845.        Page 112              AceComm (tm) v 1.85
  6846.  
  6847.  
  6848. Chapter 15  Macros list
  6849.  
  6850.            Character I/O Functions (continued)
  6851.  
  6852.    Sends PRM-data MDM_HANGUP string to modem.  Waits 1/2 second, then drops DTR
  6853.    for 1 second.
  6854.  
  6855.  
  6856. <MdmStill>
  6857.  
  6858.    <MdmStill>n
  6859.  
  6860.    Wait for n seconds where nothing arrives from the modem.
  6861.  
  6862.    <SendStr>d^M ACE185.ZIP^M
  6863.    <RecvZmo>
  6864.    <MdmStill>5 <SendStr>G^M Y^M <Delay>2 <MdmHangUp>
  6865.  
  6866.  
  6867. <SetDTR>
  6868.  
  6869.    <SetDTR> on
  6870.    <SetDTR> off
  6871.  
  6872.    Assert or Reset UART Bit for data terminal ready
  6873.  
  6874.  
  6875. <SetLCtrl>STRING
  6876.  
  6877.    <SetLCtrl>8N1
  6878.    <SetLCtrl>7E1
  6879.    <SetLCtrl>7N1
  6880.  
  6881.  
  6882. <SetBaud>STRING
  6883.  
  6884.    <SetBaud>300
  6885.    <SetBaud>1200
  6886.    <SetBaud>2400
  6887.    <SetBaud>4800
  6888.    <SetBaud>9600
  6889.    <SetBaud>19200
  6890.    <SetBaud>38400
  6891.    <SetBaud>57600
  6892.    <SetBaud>115200
  6893.  
  6894.  
  6895. -----------------------
  6896. I/O Mostly Scripts Uses
  6897. -----------------------
  6898.  
  6899.  
  6900.  
  6901.  
  6902.  
  6903.  
  6904.        Page 113              AceComm (tm) v 1.85
  6905.  
  6906.  
  6907. Chapter 15  Macros list
  6908.  
  6909.            Character I/O Functions (continued)
  6910.  
  6911.  
  6912. The sample MINIHOST.SCR included with the AceComm package demonstrates most of
  6913. the macros in this manual. Remember that macros ending in _> require local
  6914. keyboard input, so are not suited to un-attended scripts.
  6915.           Example:
  6916.                   <MdmHangUp_>  will prompt the user (Yes/no)
  6917.              where
  6918.                   <MdmHangUp>  hangs up with no (Yes/no) prompt
  6919.  
  6920.  
  6921.  
  6922.  
  6923. <CheckMdm>STRING
  6924.  
  6925.    This macro checks to see if STRING has come in from the modem.
  6926.    The macro does not wait, but sets the result for a following <if>
  6927.    to 1 or 0.
  6928.    Result to <if> is 1 or 0
  6929.  
  6930. --- Example ---
  6931. ;
  6932. ; Clear screen,  Send ansi video request,  Display banner
  6933. ;
  6934.    <Timer0>3                        ; Init Timer0 and set 3 second timeout
  6935.    <RawCapture>On                   ; Allow all caller's input in wait buffer
  6936.                                     ; ESC[6n  is video request (detect ansi)
  6937.    <SendStr>^L^[[6n^MMini Host Script for AceComm v1.85^M
  6938. ;
  6939. ; Loop here for 3 second maximum waiting for answer to Ansi detect sequence
  6940. ;
  6941. :@@DetectAnsi
  6942.    <CheckMdm> [ <if>1 <goto>@@AnsiDetected     ; Remote will answer with
  6943.    <Timer0> <if>1 <goto>@@DetectAnsi           ; ESC[n;nR  if ANSI capable
  6944.    <RawCapture>Off
  6945.    <HostEcho>ON                                ; HostEcho translates CR
  6946.                                                ; into CR,LF pair
  6947.    <DispStr>^MAnsi video request un-answered^M ; Ansi video request
  6948.    <goto>@@Welcome
  6949. :@@AnsiDetected
  6950.    <RawCapture>Off
  6951.    <HostEcho>ON                     ; HostEcho translated CR into CR,LF pair
  6952.    <SendStr> ^MAnsi video detected!^M
  6953.  
  6954. --- End Example ---
  6955.  
  6956.  
  6957.  
  6958.  
  6959.  
  6960.  
  6961.  
  6962.  
  6963.        Page 114              AceComm (tm) v 1.85
  6964.  
  6965.  
  6966. Chapter 15  Macros list
  6967.  
  6968.            Character I/O Functions (continued)
  6969.  
  6970. <DirList> PATH\*.*
  6971.  
  6972.    List a directory, can be used from host mode.
  6973.  
  6974.    <DirList>[DIR_DNLDS]\*.*
  6975.    <DirList>C:\files\*.ZIP
  6976.  
  6977. <DispStr>TEXT
  6978.  
  6979.  
  6980.    <DispStr>^M[BWhi][Blu]Hello to you![AttrOff]^M^J
  6981.  
  6982.  
  6983. <DispText> LABEL_NAME
  6984.  
  6985.    Display text defined in a data area of a script file LABEL_NAME is
  6986.    descriptive text following {-TEXT_START-} Text is displayed at current
  6987.    cursor position Text display is local
  6988.  
  6989. --- Example ---
  6990.  
  6991. :@@Top
  6992.    <ClrWin>
  6993.    <DispText>Intro
  6994.    <DispText>Ask_Continue
  6995. :GetKey
  6996.    <GetKey>60
  6997.       <if>Y <goto>Dial
  6998.       <if>N <goto>End
  6999.       <goto>GetKey
  7000. :Dial
  7001.    <INITFONREC>ACECOMM Support BBS      ; Initialize a FON RECORD
  7002.    <FON_NUM>1-602-846-2940            ;
  7003.    <FON_BAUD>19200                    ;
  7004.    <FON_TERM>Av/An                    ;
  7005.    <FON_REDIAL>                       ; Go into re dial mode
  7006.    <DispText>Connect
  7007.    <WAITSTR> your name:
  7008.    <GetDCD>                           ; <WaitStr> may have timed
  7009.    <if>1 <goto>Connect                ; out
  7010.    <goto>@@Top
  7011. :Connect
  7012.    <SENDSTR>Michael Phelps^M
  7013.    <SENDSTR>Y^M
  7014.    <SENDSTR>password^M
  7015.    <WAITSTR>Select:
  7016.  
  7017.  
  7018.  
  7019.  
  7020.  
  7021.  
  7022.        Page 115              AceComm (tm) v 1.85
  7023.  
  7024.  
  7025. Chapter 15  Macros list
  7026.  
  7027.            Character I/O Functions (continued)
  7028.  
  7029.    <SENDSTR>ff
  7030. :End
  7031.    <ENDS>
  7032.  
  7033. {-DATA_AREA-}
  7034. {-TEXT_START-}Intro
  7035. -- Generic Log On Script --
  7036. {-TEXT_END-}
  7037. {-TEXT_START-}Ask_Continue
  7038. Continue (Y/n) {-TEXT_END-}
  7039.  
  7040. {-TEXT_START-}Connect
  7041. -- Connect --
  7042. {-TEXT_END-}
  7043.  
  7044. --- End Example ---
  7045.  
  7046.  
  7047. <EndS>
  7048.  
  7049.    Marks the exit point for the script processor.
  7050.  
  7051.  
  7052. <FindUser>
  7053.  
  7054.    Searches a file names USERLIST.LST for user names.
  7055.    Result to <if> is 1 or 0
  7056.  
  7057.    Sample USERLIST.LST file contents:
  7058.  
  7059. Michael Phelps,password,9
  7060. Guest Pass,guest,1
  7061.  
  7062. The user name must be First Last,password,level
  7063. Level is not currently supported, but must be there. The commas are important.
  7064.  
  7065.  
  7066. --- Example ---
  7067.    <DispStr> ^MEnter your first and last name:
  7068.    <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd
  7069.    <DispStr> ^MEnter your first and last name:
  7070.    <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd
  7071.    <DispStr> ^MEnter your first and last name:
  7072.    <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd
  7073. :@@1
  7074.    <DispStr>^L^MYour name has not been registered in the user file, you may
  7075.  
  7076.  
  7077.  
  7078.  
  7079.  
  7080.  
  7081.        Page 116              AceComm (tm) v 1.85
  7082.  
  7083.  
  7084. Chapter 15  Macros list
  7085.  
  7086.            Character I/O Functions (continued)
  7087.  
  7088.    <DispStr>^Moptionaly leave a short not for the SysOp, pleas include your
  7089.  
  7090.  
  7091.  
  7092.  
  7093.  
  7094.  
  7095.  
  7096.  
  7097.  
  7098.  
  7099.  
  7100.  
  7101.  
  7102.  
  7103.  
  7104.  
  7105.  
  7106.  
  7107.  
  7108.  
  7109.  
  7110.  
  7111.  
  7112.  
  7113.  
  7114.  
  7115.  
  7116.  
  7117.  
  7118.  
  7119.  
  7120.  
  7121.  
  7122.  
  7123.  
  7124.  
  7125.  
  7126.  
  7127.  
  7128.  
  7129.  
  7130.  
  7131.  
  7132.  
  7133.  
  7134.  
  7135.  
  7136.  
  7137.  
  7138.  
  7139.  
  7140.        Page 117              AceComm (tm) v 1.85
  7141.  
  7142.    <DispStr>^Mfirst and last name along with a password.
  7143.    <DispStr>^M^MWould you like to leave a note? (Y)es/(N)o
  7144.    <GetKey>
  7145.    <if>Y <goto>@@LogOffComment
  7146.    <if>N <goto>@@OFF
  7147.    <Goto>@@1
  7148. --- End Example ---
  7149.  
  7150.  
  7151. <GetKey>n
  7152.  
  7153.    <GetKey>60
  7154.    The macro excepts a parameter. Seconds to wait for a key press. The
  7155.    parameter range if 1 second - (60 * 7) seconds
  7156.  
  7157.    :@@Top
  7158.          <DispText>Main_Menu
  7159.    :@@GetKey
  7160.         <GetKey>10
  7161.                   <If>L <goto>@@List
  7162.                   <If>M <Goto>@@Main
  7163.                   <If>^M <Goto>@@Top
  7164.         <GetDCD> <If>0 <goto>@@UseDroppedCarrier
  7165.         <Goto>@@GetKey
  7166.  
  7167.    When a key press is checked with the <if> macro, it is first made upper
  7168.    case. Control characters can be trapped by representing it as ^[character].
  7169.  
  7170.    To see if the user pressed the ENTER key   <if>^M
  7171.                                     ESC key   <if>^[
  7172.  
  7173.    <if> will also check for extended key presses that might be made locally.
  7174.    This needs <LocalKeys>ON.
  7175.    <If>ALT+J <Goto>@@JumpToDOS
  7176.    <If>CTRL+J <Goto>@@JumpToDOS
  7177.    <If>F11 <Goto>@@JumpToDOS
  7178.    <If>SF11 <Goto>@@JumpToDOS
  7179.    <If>CF11 <Goto>@@JumpToDOS
  7180.    <If>AF11 <Goto>@@JumpToDOS
  7181.  
  7182.  
  7183. <GetMsg>
  7184.  
  7185.    This macro will create a message.  It needs host echo on.  The macro inputs
  7186.    for From:, To:, Subject: fields.  When called after <FindUser> the From:
  7187.    field is initialized with the user's name.  The macro write a message header
  7188.    to the beginning of the message file.  The message text is taken from the
  7189.    screen after the user saves the message with CONTROL Z.  Message filenames
  7190.    are created as 1.MSG, 2.MSG, 3.MSG etc.  The macro is designed for a small
  7191.    number of messages.  It will create the first filename that does not exist.
  7192.  
  7193.    See <ReadMsg>  and  <YourMsg> macros.
  7194.  
  7195.  
  7196.  
  7197.  
  7198.  
  7199.  
  7200.        Page 118              AceComm (tm) v 1.85
  7201.  
  7202.  
  7203. Chapter 15  Macros list
  7204.  
  7205.            Character I/O Functions (continued)
  7206.  
  7207.  
  7208.  
  7209. <GetStr>n
  7210.  
  7211.    <GetStr>36
  7212.    Parameter n is the maximum characters to allow entered. Range is 1 - 128.
  7213.    The macro is used for the <FindUser>, <UserPwd>, and %FN.
  7214.    %FN maximum length is 80 characters.
  7215.    %FN always represents the string entered with <GetStr>.
  7216.  
  7217.        <DispStr> ^M^JEnter your first and last name:
  7218.        <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd
  7219.        <DispStr>^M^J^G%FN not found in user list!
  7220.        <Goto>@@DumpCaller
  7221.    :@@GetPwd
  7222.  
  7223.  
  7224. <GoTo>
  7225.  
  7226.    Can be used alone or after an <If> macro.
  7227.    Parameter to <GoTo> is a label. Labels begin with a :.
  7228.    Labels need to be unique character strings.
  7229.  
  7230.    <GoTo>@@Done
  7231.  
  7232.    <GetDCD> <if>1 <Goto>@@Carrier
  7233.                   <Goto>@@OffLine
  7234.  
  7235.    <CheckMdm>password: <if>1 <Goto>@@SendPwd
  7236.  
  7237.  
  7238. <If>
  7239.    Can only be used after macros that produce a result.
  7240.  
  7241.  
  7242.       <GetDCD>   <if>1 <Goto>@@DCD
  7243.       <CheckMdm> <If>0 <Goto>@@WaitStr
  7244.       <Timer0>   <If>1 <Goto>@@WaitStr
  7245.       <Timer1>   <If>0 <Goto>@@Timeout
  7246.       <FindUser> <If>0 <Goto>@@DumpCaller
  7247.       <UserPwd>  <If>0 <Goto>@@LetCallerLeaveMsg
  7248.       <GetKey>   <If>^M <Goto>@@UserEnter
  7249.  
  7250. <LocalKeys>
  7251.  
  7252. <LocalKeys> on
  7253.  
  7254.  
  7255.  
  7256.  
  7257.  
  7258.  
  7259.        Page 119              AceComm (tm) v 1.85
  7260.  
  7261.  
  7262. Chapter 15  Macros list
  7263.  
  7264.            Character I/O Functions (continued)
  7265.  
  7266. <LocalKeys> off
  7267. <LocalKeys>
  7268.  
  7269.    3 way macro
  7270.    Enable/disable local LUI key press during script (host mode)
  7271.  
  7272.  
  7273. <NCWaitStr> STRING
  7274.  
  7275.    Non CaSe sensitive version of <WaitStr>
  7276.  
  7277.    Waits for a string (sequence of characters) to come in the
  7278.    from the modem.  Can Timeout. If <WaitStr> times out, it falls through.
  7279.  
  7280.    Timeout seconds is set with <WaitTime>n
  7281.  
  7282.           <WaitStr> name:
  7283.                    |
  7284.                    leading <SP> character is part of search
  7285.  
  7286.  
  7287. <ReadMsg>
  7288.  
  7289.    This macro displays the messages found. A key press is prompted between
  7290.    each message.
  7291.  
  7292.  
  7293. <SendStr> STRING
  7294.  
  7295.    Sends a string to the modem.
  7296.  
  7297.        <SendStr>^M
  7298.  
  7299.        Send a single CR_CHAR
  7300.  
  7301.  
  7302.        <SendStr> Michael Phelps^M
  7303.  
  7304.        Notes: the leading space character is part of STRING
  7305.  
  7306.  
  7307.       <SendStr>[USER_NAME]^M~Y^M~[FON_PWD]
  7308.  
  7309.        Send IEMSI data user name field, a <CR> char, 1 second pause, Y, <CR>
  7310.        char, 1 second pause, current Fon.Record.Password.
  7311.  
  7312.  
  7313.  
  7314.  
  7315.  
  7316.  
  7317.  
  7318.        Page 120              AceComm (tm) v 1.85
  7319.  
  7320.  
  7321. Chapter 15  Macros list
  7322.  
  7323.            Character I/O Functions (continued)
  7324.  
  7325.  
  7326.       <SendStr>[USER_NAME]^M^M[PASSWORD]^M
  7327.  
  7328.        Send IEMSI data user name field, 2 <CR> chars, IEMSI data password
  7329.        field.
  7330.  
  7331.  
  7332. <Timer0>
  7333. <Timer1>
  7334.  
  7335.    Two separate timers
  7336.    A parameter to the <Timer0> macro sets the timeout time in seconds
  7337.    Result to <if> is 1 or 0
  7338.  
  7339.    <Timer0>30  Sets a timeout of 30 seconds for Timer 0
  7340.  
  7341.    <Timer0>    Sets the result for an <if> to 1 or 0.   0 if the timer has
  7342.                expired,
  7343.    <Timer1> works the same way.
  7344.  
  7345.  
  7346. <UserPwd>
  7347.  
  7348.    This macro can only be called immediately after the <FindUser> macro.
  7349.    This macro will verify the password. Success or failure is determined with
  7350.    the immediate call to <if> macro. (see below)
  7351.    Result to <if> is 1 or 0
  7352.  
  7353. --- Example ---
  7354.    <DispStr> ^MEnter password:
  7355.    <GetStr>26 <UserPwd> <if>1 <goto>@@MainMenu
  7356.    <DispStr> ^MEnter password:
  7357.    <GetStr>26 <UserPwd> <if>1 <goto>@@MainMenu
  7358.    <DispStr> ^MEnter password:
  7359.    <GetStr>26 <UserPwd> <if>0 <goto>@@OFF
  7360.                               <goto>@@MainMenu
  7361. --- End Example ---
  7362.  
  7363.  
  7364. <Var0>
  7365. <Var1>
  7366.  
  7367.    Variables that can store a result.
  7368.  
  7369. --- Example ---
  7370. ;
  7371.  
  7372.  
  7373.  
  7374.  
  7375.  
  7376.  
  7377.        Page 121              AceComm (tm) v 1.85
  7378.  
  7379.  
  7380. Chapter 15  Macros list
  7381.  
  7382.            Character I/O Functions (continued)
  7383.  
  7384. ; Clear screen,  Send ansi video request,  Display banner
  7385. ;
  7386.    <Var0>0                          ; See if we can set this to 1 with
  7387.                                     ; our ansi video detection scheme.
  7388.    <Timer0>3                        ; Init Timer0 and set 3 second timeout
  7389.    <RawCapture>On                   ; Allow all caller's input in wait buffer
  7390.                                     ; ESC[6n  is video request (detect ansi)
  7391.    <SendStr>^L^[[6n^MMini Host Script for AceComm v1.85^M
  7392. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  7393. ;
  7394. ; Loop here for 3 second maximum waiting for answer to Ansi detect sequence
  7395. ;
  7396. :@@DetectAnsi
  7397.    <CheckMdm> [ <if>1 <goto>@@AnsiDetected     ; Remote will answer with
  7398.    <Timer0> <if>1 <goto>@@DetectAnsi           ; ESC[n;nR  if ANSI capable
  7399.    <RawCapture>Off
  7400.    <HostEcho>ON                                ; HostEcho translates CR
  7401.                                                ; into CR,LF pair
  7402.    <DispStr>^M^JAnsi video request un-answered ; Ansi video request
  7403.    <goto>@@Welcome
  7404. :@@AnsiDetected
  7405.    <Var0>1
  7406.    <RawCapture>Off
  7407.    <HostEcho>ON                     ; HostEcho translated CR into CR,LF pair
  7408.    <SendStr> ^M^JAnsi video detected!
  7409.  
  7410. :@@Welcome
  7411.    ;
  7412.    ; %C is the connect speed
  7413.    ;
  7414.    <Var0> <if>1 <DispStr>^M^J[Whi]Connected at [Blink][Bold][Red]%C[AttrOff]
  7415.    <Var0> <if>0 <DispStr>^M^JConnected at  %C
  7416.  
  7417. --- End Example ---
  7418.  
  7419.  
  7420. <WaitStr> STRING
  7421.  
  7422.    Waits for a CASE sensitive string (sequence of characters) to come in the
  7423.    from the modem.  Can Timeout. If <WaitStr> times out, it falls through.
  7424.  
  7425.    Timeout seconds is set with <WaitTime>n
  7426.  
  7427.           <WaitStr> name:
  7428.                    |
  7429.                    leading <SP> character is part of search
  7430.  
  7431.  
  7432.  
  7433.  
  7434.  
  7435.  
  7436.        Page 122              AceComm (tm) v 1.85
  7437.  
  7438.  
  7439. Chapter 15  Macros list
  7440.  
  7441.            Character I/O Functions (continued)
  7442.  
  7443.  
  7444.  
  7445. <WaitTime> n
  7446.  
  7447.    Where n is in seconds Set the timeout value for <WaitStr> (default is 40
  7448.    seconds)
  7449.  
  7450.       <Timer0>10
  7451.       <WaitTime>15
  7452.       <WaitStr>name?
  7453.       <Timer0> <if>0 <goto>@@Timeout
  7454.       <SendStr>[USER_NAME]^M
  7455.    :@@TimeOut
  7456.  
  7457.  
  7458. <YourMsg>
  7459.  
  7460.    This macro is the same as <ReadMsg>, except that the To: field in the
  7461.    message header must match the caller's name.
  7462.    You can use this macro to display personal messages to the callers.
  7463.    Messages must be created with <GetMsg>.
  7464.  
  7465.  
  7466.  
  7467.  
  7468.  
  7469. ------------------------
  7470. Internal Protocols Flags
  7471. ------------------------
  7472.  
  7473. <AutoD> on/off
  7474.  
  7475.    Enable/disable auto engage sequence scanning for protocols
  7476.  
  7477.    Does not affect auto log on
  7478.  
  7479.  
  7480. <Resume> on/off
  7481.  
  7482.    Enable/disable file resume (internal zmodem receive)
  7483.  
  7484.  
  7485. <Rename> on/off
  7486.  
  7487.    Enable/disable file rename (internal zmodem receive)
  7488.  
  7489.  
  7490.  
  7491.  
  7492.  
  7493.  
  7494.  
  7495.        Page 123              AceComm (tm) v 1.85
  7496.  
  7497.  
  7498. Chapter 15  Macros list
  7499.  
  7500.            Flags
  7501.  
  7502.  
  7503. -------------
  7504. General Flags
  7505. -------------
  7506.  
  7507. <SwapSpawn> on/off
  7508.  
  7509.    3 way toggle
  7510.    Enable/disable swap to EMS/XMS/DISK for <RunProg> macro
  7511.  
  7512.  
  7513. <SwapShell> on/off
  7514.  
  7515.    3 way toggle
  7516.    Enable/disable swap to EMS/XMS/DISK for <CommandShell_> macro
  7517.  
  7518.  
  7519. <DTRExit> on/off
  7520.  
  7521.    3 way toggle
  7522.    DTR state for <EndAceComm> macro
  7523.  
  7524.  
  7525. <Scheds> on/off
  7526.  
  7527.    <Scheds>ON     ; Enable
  7528.    <Scheds>OFF    ; Disable
  7529.    <Scheds>       ; Toggle
  7530.  
  7531.    3 way toggle
  7532.    This macro will simply turn the schedules on or off.
  7533.  
  7534.  
  7535.  
  7536.  
  7537.  
  7538.  
  7539. <RawCapture>on/off
  7540.  
  7541.    <RawCapture>on
  7542.    <RawCapture>off
  7543.    <RawCapture>
  7544.  
  7545.    3 way toggle
  7546.    <rawCapture>ON <OpenCapture>xmas.ans
  7547.  
  7548.  
  7549.  
  7550.  
  7551.  
  7552.  
  7553.  
  7554.        Page 124              AceComm (tm) v 1.85
  7555.  
  7556.  
  7557. Chapter 15  Macros list
  7558.  
  7559.            File Functions
  7560.  
  7561.    Captured data will be stored with or without video control characters.  The
  7562.    current video emulation must mach that of the host.
  7563.  
  7564.    AN/AV covers both Ansi and Avatar video at the same time ans is the AceComm
  7565.    default video type.
  7566.  
  7567.  
  7568. <ChgDir> FILENAME
  7569.  
  7570.    Make FILENAME current directory
  7571.    This macro can change drives
  7572.  
  7573.    <ChgDir>C:\WORK\TXT <ToPrn>melissa.01 <ChgDir>[DIR_START]
  7574.  
  7575.    <ChgDir>[FIR_DNLDS] <RunProg>DSZ port %P speed %B rz -mr <ChgDir>[DIR_START]
  7576.  
  7577.    Notes: [DIR_START] is the directory Acecomm is started in.
  7578.           [DIR_DNLDS] is the directory pointed to inside PRM-data
  7579.           "Directories" menu for "Downloads".
  7580.  
  7581.  
  7582. <CloseCapture>
  7583.  
  7584.    Close the current open capture file, or just returns if none is open.
  7585.  
  7586.    Capture files are stamped with date/time when closed.
  7587.  
  7588.    Capture files are automatically closed on detection of a loss in carrier.
  7589.  
  7590.    Capture files are automatically closed when the <OpenCapture> macro is
  7591.    called, so that any previous open capture file is sure to be closed before
  7592.    opening the new one.
  7593.  
  7594.  
  7595. <FileDel> FILENAME
  7596.  
  7597.    If the file exists, it will be deleted without prompt.  Use full path name
  7598.    if not in current directory.
  7599.  
  7600.  
  7601. <OpenCapture> FILENAME
  7602.  
  7603.    Calling this function opens a capture file in the directory path defined
  7604.    inside PRM-data Area "Directories" menu, .CAP files.
  7605.  
  7606.    Existing capture files of same FILENAME are appended to.  DOS eof character
  7607.  
  7608.  
  7609.  
  7610.  
  7611.  
  7612.  
  7613.        Page 125              AceComm (tm) v 1.85
  7614.  
  7615.  
  7616. Chapter 15  Macros list
  7617.  
  7618.            File Functions (continued)
  7619.  
  7620.    may end up just ahead of the time stamp.
  7621.  
  7622.    This function will first close any previously opened capture file, properly
  7623.    saving it to disk.
  7624.  
  7625.    Capture files are stamped with date/time when opened.
  7626.  
  7627.    Capture files can record either in "Raw" or "Text" mode. "Raw" mode being
  7628.    where no video control characters are filtered. "Text" being everything
  7629.    that the current video emulation does not pick out.
  7630.  
  7631.    See also <RawCapture> macro
  7632.  
  7633.  
  7634. <RunScript> FILENAME
  7635.  
  7636.    Open and run FILENAME
  7637.  
  7638.    Notes: Just FILENAME no PATH.  PATH found in PRM-data for SCR directory is
  7639.           used.
  7640.           Note the difference between <RunScript> and <RunScript_>, where
  7641.           the later does filename prompting.
  7642.  
  7643. <RunProg> FILENAME
  7644.  
  7645.    Spawn an executable file.
  7646.  
  7647.    Can search the DOS PATH.
  7648.  
  7649.    Can determine files's extension (.COM, .EXE).
  7650.  
  7651.    All system ISRS are restored before the spawn takes place.  The serial port
  7652.    is un-hooked.  The state of DCD, and LINE CONTROL are left in tact.
  7653.  
  7654.    After the spawn the system ISRs AceComm uses are taken back, the serial port
  7655.    is re-assumed.
  7656.  
  7657.    SWAP FLAG "ON" and XMS,EMS, or DISK swapping takes place.  SWAP FLAG "OFF"
  7658.    and AceComm is left in memory, with exception to first restoring the serial
  7659.    port and interrupts.
  7660.  
  7661.  
  7662. <SetFonFile> FILENAME
  7663.  
  7664.    Tacks FILENAME onto the PATH defined in PRM DATA for .FON files.  AceComm
  7665.    keeps track of the current(last accessed) .FON file.  FILENAME becomes the
  7666.  
  7667.  
  7668.  
  7669.  
  7670.  
  7671.  
  7672.        Page 126              AceComm (tm) v 1.85
  7673.  
  7674.  
  7675. Chapter 15  Macros list
  7676.  
  7677.            File Functions (continued)
  7678.  
  7679.    current .FON file.  <SetFonFile> 1_114.fon <DialRecord> 1
  7680.  
  7681.  
  7682. <ToPrn> FILENAME
  7683.  
  7684.    Send FILENAME to the printer.
  7685.  
  7686.    Notes: This macro opens the filename PRN using DOS file handle function, and
  7687.           writes the file.  Any character translation DOS may do will depend
  7688.           upon the IOCTL functions of DOS.  (eof etc.)
  7689.  
  7690.  
  7691.  
  7692.  
  7693.  
  7694. Internal receiver protocols will receive to the sub directory for Downloads as
  7695. setup inside the PRM-data "Directories" menu.
  7696.  
  7697.  
  7698. <SendAscii> FILENAME
  7699.  
  7700.    Outputs from a file to the modem.  Sends the complete file.  Does *NO*
  7701.    CONTROL CHARACTER TRANSLATION.  Data sent to the modem is paced for buffer
  7702.    FULL, and all handshaking is valid.
  7703.  
  7704.    ESC-key press aborts the function.
  7705.  
  7706.  
  7707. <SendZmo@> @FILENAME
  7708.  
  7709.    Where @FILENAME is a LISTFILE
  7710.    The @ denotes a LISTFILE
  7711.    Filenames contained in the listfile should be full drive path filenames,
  7712.    if not all contained in the current working directory.
  7713.  
  7714.    Call internal zmodem sending unit with 1k data frame size.
  7715.    ESC-key press aborts the function.
  7716.  
  7717.  
  7718. <SendZmo> FILENAME
  7719.  
  7720.    Call internal zmodem sending unit with 1k data frame size.
  7721.    ESC-key press aborts the function.
  7722.  
  7723.  
  7724. <SendYmo> FILENAME
  7725.  
  7726.  
  7727.  
  7728.  
  7729.  
  7730.  
  7731.        Page 127              AceComm (tm) v 1.85
  7732.  
  7733.  
  7734. Chapter 15  Macros list
  7735.  
  7736.            Data Transfer functions
  7737.  
  7738.  
  7739.    Call internal ymodem sending unit with 128 byte data frame size.
  7740.    ESC-key press aborts the function.
  7741.  
  7742.  
  7743. <SendYmo1k> FILENAME
  7744.  
  7745.    Call internal ymodem sending unit with 1k data frame size.
  7746.    ESC-key press aborts the function.
  7747.  
  7748.  
  7749. <SendYmoG> FILENAME
  7750.  
  7751.    Call internal ymodemG sending unit with 1k data frame size.
  7752.    ESC-key press aborts the function.
  7753.  
  7754.  
  7755. <SendXmo> FILENAME
  7756.  
  7757.    Call internal xmodem sending unit with 128 byte data frame size.
  7758.    ESC-key press aborts the function.
  7759.  
  7760.  
  7761. <SendXmo1k> FILENAME
  7762.  
  7763.    Call internal xmodem sending unit with 1k data frame size.
  7764.    ESC-key press aborts the function.
  7765.  
  7766.  
  7767. <RecvAscii> FILENAME
  7768.  
  7769.    Ascii receiver will close the file when End Of File "eof" character is
  7770.    seen.  Eof character is set from inside "Protocol Options" menu.  The
  7771.    default eof character is the DOS standard 26d.
  7772.    ESC-key press aborts the function.
  7773.  
  7774.  
  7775. <RecvZmo>
  7776.  
  7777.    Call internal zmodem recv unit.  AceComm's internal zmodem receiver is
  7778.    capable of up to 8k data frame size.  The receive unit will continue in
  7779.    batch mode until the sender stops sending files, or the user terminates the
  7780.    transfer.  Files are placed into the directory pointed to in the PRM-data
  7781.    area for Downloads.
  7782.    ESC-key press aborts the function.
  7783.  
  7784.  
  7785.  
  7786.  
  7787.  
  7788.  
  7789.  
  7790.        Page 128              AceComm (tm) v 1.85
  7791.  
  7792.  
  7793. Chapter 15  Macros list
  7794.  
  7795.            Data Transfer functions (continued)
  7796.  
  7797.  
  7798. <RecvYmo>
  7799.  
  7800.    Call internal ymodem.  The receive unit will continue in batch mode until
  7801.    the sender stops sending files, or the user terminates the transfer.  Files
  7802.    are placed into the directory pointed to in the PRM-data area for Downloads.
  7803.    ESC-key press aborts the function.
  7804.  
  7805.  
  7806. <RecvYmo1K>
  7807.  
  7808.    Call internal ymodem1K.  The receive unit will continue in batch mode until
  7809.    the sender stops sending files, or the user terminates the transfer.  Files
  7810.    are placed into the directory pointed to in the PRM-data area for Downloads.
  7811.    ESC-key press aborts the function.
  7812.  
  7813.  
  7814. <RecvYmoG>
  7815.  
  7816.    Call internal ymodemG.  The receive unit will continue in batch mode until
  7817.    the sender stops sending files, or the user terminates the transfer.  Files
  7818.    are placed into the directory pointed to in the PRM-data area for Downloads.
  7819.    ESC-key press aborts the function.
  7820.  
  7821.  
  7822. <RecvXmo> FILENAME
  7823.  
  7824.    Call internal xmodem.  Files are placed into the directory pointed to in the
  7825.    PRM-data area for Downloads.
  7826.    ESC-key press aborts the function.
  7827.  
  7828.  
  7829. <RecvXmo1K> FILENAME
  7830.  
  7831.    Call internal xmodem1k.  Files are placed into the directory pointed to in
  7832.    the PRM-data area for Downloads.
  7833.    ESC-key press aborts the function.
  7834.  
  7835.  
  7836. <SendEMSI_CLI>
  7837.  
  7838.    Send an EMSI_CLI HDR sequence to modem
  7839.  
  7840.    BBS mailer front ends that use EMSI handshake protocol will, if EMSI is
  7841.    implemented properly, interpret an "EMSI_CLI" HDR sequence, as "this is a
  7842.    human caller" and drop to the BBS without any delay.  Note: At this writing
  7843.  
  7844.  
  7845.  
  7846.  
  7847.  
  7848.  
  7849.        Page 129              AceComm (tm) v 1.85
  7850.  
  7851.  
  7852. Chapter 15  Macros list
  7853.  
  7854.            Data Transfer functions (continued)
  7855.  
  7856.    Front Door, and Binkley recognize EMSI_CLI HDR.  DBridge does not.  See
  7857.    default AutoD trigger assignments (ACE.CTL)
  7858.  
  7859.  
  7860. <SendEMSI_ICI>
  7861.  
  7862.    IEMSI support macro
  7863.    Send an EMSI_ICI data packet to modem
  7864.  
  7865.    EMSI_ICI is a response made by the caller (CLIENT) to a BBS system (HOST)
  7866.    which supports Interactive EMSI handshake protocol.  IEMSI data is contained
  7867.    inside the PRM-data area.  This data can be used for automating log on when
  7868.    call a BBS that supports IEMSI.  See default AutoD trigger assignments
  7869.    (ACE.CTL)
  7870.  
  7871.  
  7872.  
  7873.  
  7874. Notes: Xmodem/Ymodem Receive units are capable of adopting to frame size.
  7875.        128 / 1024 data frames are determined by the sender and can be sent in
  7876.        any combination.
  7877.  
  7878.        The Internal Zmodem in AceComm is capable of up to 8k data frames.  For
  7879.        compatibility, AceComm only uses larger than 1k data frames with it's
  7880.        sending unit in mailer modes.  AceComm's zmodem receive unit can handle
  7881.        up to 8k data frames at any time.
  7882.        The internal zmodem can make filename management decisions based on the
  7883.        status of option flags for "resume" and "rename".
  7884.  
  7885.  
  7886.  
  7887.  
  7888.  
  7889. <DialNum> PHONE_NUMBER
  7890.  
  7891.    Builds a dial string.  Uses PRM-data MDM_DIAL_PREFIX and PHONE_NUMBER Sends
  7892.    the dial string to the modem.  One time.  No re dials as this will typically
  7893.    take place from terminal area.
  7894.  
  7895.  
  7896. <DialRecord> n
  7897.  
  7898.    Retrieves the n record found in current .FON file
  7899.  
  7900.    Re dials number until CONNECT or USER ABORT
  7901.  
  7902.  
  7903.  
  7904.  
  7905.  
  7906.  
  7907.  
  7908.        Page 130              AceComm (tm) v 1.85
  7909.  
  7910.  
  7911. Chapter 15  Macros list
  7912.  
  7913.            Dialing/Fon.Record
  7914.  
  7915.        <SetFonFile> 1_114.FON <DialRecord> 1
  7916.  
  7917.  
  7918.  
  7919. -----------------------------------------
  7920. For creating a Fon.Record inside a script
  7921. -----------------------------------------
  7922.  
  7923. <InitFonRec> RECORD NAME
  7924.  
  7925.    This MACRO must be called first.  The MACRO initializes a FON RECORD with
  7926.    AceComm defaults.  RECORD NAME is copied into the system name for this
  7927.    record.
  7928.  
  7929.       <InitFonRec> Compuserve
  7930.  
  7931.  
  7932. <Fon_Num> PHONE_NUMBER
  7933.  
  7934.    Set the phone number field.  Any dial statements in ACE.CFG will be applied
  7935.    to this number when AceComm builds the dial string.
  7936.  
  7937.       <Fon_Num>468-0285
  7938.  
  7939.  
  7940. <Fon_Baud>BAUD
  7941.  
  7942.    If using a locked port, AceComm will ignore this value when getting ready to
  7943.    dial.
  7944.  
  7945.       <Fon_Baud>19200
  7946.  
  7947.  
  7948. <Fon_LineCtrl> DATA_PARITY_STOPBIT
  7949.  
  7950.    Valid parameters are as follows
  7951.          8n1
  7952.          7e1
  7953.          7n1
  7954.  
  7955.       <Fon_LineCtrl>8n1
  7956.  
  7957.  
  7958. <Fon_Flags> FLAG, FLAG
  7959.  
  7960.    Possible Control Flags
  7961.  
  7962.  
  7963.  
  7964.  
  7965.  
  7966.  
  7967.        Page 131              AceComm (tm) v 1.85
  7968.  
  7969.  
  7970. Chapter 15  Macros list
  7971.  
  7972.            Dialing/Fon.Record (continued)
  7973.  
  7974.  
  7975.    "Script" when set,
  7976.  
  7977.    AceComm will attempt to load and run the filename defined next to "AutoLogOn
  7978.    Script".  If a script file is not found, AceComm ignores the error and
  7979.    continues normal operation.
  7980.  
  7981.    Notes: .SCR files are looked for in the directory defined inside PRM-data
  7982.            Area "Directories"
  7983.  
  7984.  
  7985.    "Macro"  when  set,
  7986.  
  7987.    AceComm will enable the defined Auto Log on Sequence Triggers and
  7988.    corresponding MACRO stacks.
  7989.  
  7990.  
  7991.    "DTag"  when  set,
  7992.  
  7993.    AceComm will tag un-successful dial attempts (busy, etc.) to the Que
  7994.    Dialer.  An "*" character appears to the left of a Fon.Record's display
  7995.    line, when it is either Q tagged or, D tagged.  When this flag is not set,
  7996.    the only other way to Q tag a record is by manually selecting the menu
  7997.    option "<SPACEBAR>-Que" from the fon list display.
  7998.  
  7999.  
  8000.    "Capture" when  set,
  8001.  
  8002.    When this flag is selected, a capture file is opened upon
  8003.    Dial/Connect.  Any previously open capture file is first
  8004.    closed.
  8005.  
  8006.  
  8007.    "Raw"  when set,
  8008.  
  8009.    Data to capture file is as it comes in from the modem
  8010.  
  8011.  
  8012.    "Text"  when set,
  8013.  
  8014.    Data to capture file is filtered of video control codes
  8015.    as applicable to the current Video type
  8016.  
  8017.  
  8018.    "IEMSI"  when  set,
  8019.  
  8020.  
  8021.  
  8022.  
  8023.  
  8024.  
  8025.  
  8026.        Page 132              AceComm (tm) v 1.85
  8027.  
  8028.  
  8029. Chapter 15  Macros list
  8030.  
  8031.            Dialing/Fon.Record (continued)
  8032.  
  8033.    Allow Interactive EMSI log on
  8034.  
  8035.   "AutoL"
  8036.  
  8037.   Allow auto log on methods (script/macro)
  8038.  
  8039.  
  8040. <Fon_Term> VIDEO_TYPE
  8041.  
  8042.       - Valid parameters are as follows
  8043.  
  8044.         TTY
  8045.         Ansi
  8046.         Avatar
  8047.         Av/An
  8048.         VT102
  8049.  
  8050.       <Fon_Term>Av/An
  8051.  
  8052.  
  8053. <Fon_CapFile> FILENAME
  8054.  
  8055.  
  8056. <Fon_Redial>
  8057.  
  8058.    Presents the FON record to the AceComm re dial function.
  8059.  
  8060. <Redials>n
  8061.  
  8062.    Where n is the number of redials before giving up.  This macro works only
  8063.    when dialing from a script using the <FON_ReDial> macro.  <ReDials> does
  8064.    not affect normal interactive use, and is not the same as the menu option
  8065.    found inside the "Point Mail" "Options" menu.
  8066.  
  8067.  
  8068.  
  8069.  
  8070.  
  8071.  
  8072. <Alarm> SECONDS
  8073.  
  8074.    Sound alarm for SECONDS
  8075.  
  8076.  
  8077. <BbsEndAceComm>
  8078.  
  8079.  
  8080.  
  8081.  
  8082.  
  8083.  
  8084.  
  8085.        Page 133              AceComm (tm) v 1.85
  8086.  
  8087.  
  8088. Chapter 15  Macros list
  8089.  
  8090.            Misc Functions
  8091.  
  8092.    This macro will Exit AceComm with an error level based on the current baud
  8093.    setting.  Baud is taken from the UART, and if the port is locked, will vary
  8094.    from the connect speed.
  8095.  
  8096.    Error level is decimal of the first 2 ascii decimal digits of the current
  8097.    UART baud setting.
  8098.  
  8099.    DTR state is left as is.
  8100.  
  8101.    Error levels returned are:
  8102.                              57 - 57600
  8103.                              38 - 38400
  8104.                              19 - 19200
  8105.                              96 -  9600
  8106.                              48 -  4800
  8107.                              24 -  2400
  8108.                              12 -  1200
  8109.                              30 -   300
  8110.    Sample use:
  8111. :Start
  8112.    echo off
  8113.    ace
  8114.    if error level 96 goto error96
  8115.    if error level 57 goto error57
  8116.    if error level 48 goto error48
  8117.    if error level 38 goto error38
  8118.    if error level 24 goto error24
  8119.    if error level 19 goto error19
  8120.    goto start
  8121. :error57
  8122.    BBS.EXE 57600
  8123.    goto Start
  8124. :error38
  8125.    BBS.EXE 38400
  8126.    goto Start
  8127. :error19
  8128.    BBS.EXE 19200
  8129.    goto Start
  8130. :error96
  8131.    BBS.EXE 9600
  8132.    goto Start
  8133. :error48
  8134.    BBS.EXE 4800
  8135.    goto Start
  8136. :error24
  8137.    BBS.EXE 2400
  8138.  
  8139.  
  8140.  
  8141.  
  8142.  
  8143.  
  8144.        Page 134              AceComm (tm) v 1.85
  8145.  
  8146.  
  8147. Chapter 15  Macros list
  8148.  
  8149.            Misc Functions (continued)
  8150.  
  8151.    goto Start
  8152. :error12
  8153.    BBS.EXE 1200
  8154.    goto Start
  8155. :End
  8156.  
  8157.  
  8158. <ClrWin>
  8159.  
  8160.    Clear screen. Clears screen above status line
  8161.  
  8162.  
  8163. <Delay> SECONDS
  8164.  
  8165.    Create program function delay.
  8166.  
  8167.    <SendStr>Go IBMCOM^M <OpenCapture>ibmcom <Delay>7 <SendStr>Read New^M
  8168.    <Delay> allows I/O, you could trip your <CheckMdm> with this one.
  8169.  
  8170.  
  8171. <EndAceComm> ERROR LEVEL
  8172.  
  8173.    <EndAceComm> 0
  8174.    AceComm session end with error level
  8175.  
  8176.    Exit AceComm back to the operating system.  End AceComm session.  A QUICK
  8177.    snap, no prompt "Are you sure?".  If your on line, your still on line when
  8178.    you come back unless "drop DTR on exit is SET"
  8179.  
  8180.    See Drop DTR on EXIT flag inside Terminal Area Options
  8181.  
  8182.    Notes: Pressing CONTROL BREAK will always end AceComm.  CONTROL BREAK is a
  8183.          back door to the <EndAceComm> macro.  When you exit the program by
  8184.          pressing CONTROL BREAK, all data is saved as usual, and program
  8185.          cleanup is as it would be using the <EndAceComm> macro.
  8186.  
  8187.  
  8188. <PollBoss>1-5
  8189.  
  8190.    This macros take BOSS data and builds a FLO file.  The macro then creates a
  8191.    Fon.Record with the BOSS info and goes into mailer mode.  If the connect is
  8192.    un-successful or aborted, the FLO file still exits in the MAIL OUT
  8193.    directory.  Any schedule that allows mail will see the FLO file and cause
  8194.    the system to be polled again.
  8195.    Long distance calls need the "LD," schedule flag,
  8196.  
  8197.  
  8198.  
  8199.  
  8200.  
  8201.  
  8202.  
  8203.        Page 135              AceComm (tm) v 1.85
  8204.  
  8205.  
  8206. Chapter 15  Macros list
  8207.  
  8208.            Misc Functions (continued)
  8209.  
  8210.  
  8211. <RingBell> SECONDS
  8212.  
  8213.    A value of 0 does not ring bell, a value of 1 plays a victory tune, values
  8214.    from 2 - 30 ring the internal bell for the number of seconds.  This is the
  8215.    same bell sound heard in the Dial/Connect window.
  8216.  
  8217.  
  8218. <Wait_To_HHMM> hh:mm
  8219.  
  8220.    Wait until hour:minute 24 hour format leading zeros not needed
  8221.  
  8222.            <Wait_To_HHMM>4:10    is valid
  8223.  
  8224. --- Example ---
  8225.     <Wait_To_HHMM>15:45                ; wait till 3:45 pm
  8226.     <INITFONREC>A.C.E. Software Support; call Init FON function
  8227.     <FON_NUM>1-602-846-2940            ; set phone number
  8228.     <FON_BAUD>2400
  8229.     <FON_TERM>Av/An                    ; video type for script
  8230.     <FON_REDIAL>                       ; call redial function
  8231.     <WAITSTR>it a few moments.
  8232.     <SENDSTR>^M
  8233.     <WAITSTR>s your name:
  8234.     <SENDSTR>Michael Phelps^M
  8235.     <WAITSTR>ael Phelps [Y,n]?
  8236.     <SENDSTR>^M
  8237.     <WAITSTR>Password:
  8238.     <SENDSTR>melissa_jean^M
  8239.     <WAITSTR>Select:
  8240.     <SENDSTR>f^M
  8241.     <SENDSTR>d^Mz^Mace170.arj^M
  8242.     <RecvZmo>
  8243.     <WAITSTR>Select:
  8244.     <SENDSTR>gyn^M
  8245.     <ENDS>
  8246. --- End Example ---
  8247.  
  8248.  
  8249.  
  8250.  
  8251.  
  8252.  
  8253.  
  8254.  
  8255.  
  8256.  
  8257.  
  8258.  
  8259.  
  8260.  
  8261.  
  8262.        Page 136              AceComm (tm) v 1.85
  8263. Chapter 16  MACRO Parameter Symbols
  8264.  
  8265. Chapter 16  MACRO Parameter Symbols
  8266.  
  8267.  
  8268.  
  8269.  
  8270. o MACRO parameters are UPPER case only
  8271. -----------
  8272. Fon.Records
  8273. -----------
  8274.  
  8275. [FON_PWD]
  8276.  
  8277.    Replaced with the current Fon.Record "password"
  8278.  
  8279.  
  8280. [FON_ALIAS]
  8281.  
  8282.    Replaced with the current Fon.Record "alias"
  8283.  
  8284.  
  8285. [FON_ID]
  8286.  
  8287.    Replaced with the current Fon.Record "ID"
  8288.  
  8289.  
  8290. [FON_CAP]
  8291.  
  8292.    Replaced with the current Fon.Record CAPTURE "filename"
  8293.  
  8294.  
  8295. [FON_SCR]
  8296.  
  8297.    Replaced with the current Fon.Record SCRIPT "filename"
  8298.  
  8299.  
  8300.  
  8301.  
  8302. --------------
  8303. PRM-data IEMSI
  8304. --------------
  8305.  
  8306. [USER_NAME]
  8307.  
  8308.    Replaced with the current PRM-data/IEMSI "User Name"
  8309.  
  8310.       <SendStr> [USER_NAME]
  8311.  
  8312.  
  8313. [ALIAS]
  8314.  
  8315.  
  8316.  
  8317.  
  8318.  
  8319.  
  8320.  
  8321.        Page 137              AceComm (tm) v 1.85
  8322.  
  8323.  
  8324. Chapter 16  MACRO Parameter Symbols
  8325.  
  8326.            PRM-data Representatives
  8327.  
  8328.    Replaced with the current PRM-data/IEMSI "alias"
  8329.  
  8330.  
  8331. [LOCATION]
  8332.  
  8333.    Replaced with the current PRM-data/IEMSI "location"
  8334.  
  8335.  
  8336. [DATA_PNUM]
  8337.  
  8338.    Replaced with the current PRM-data/IEMSI "data #"
  8339.  
  8340.  
  8341. [VOICE_PNUM]
  8342.  
  8343.    Replaced with the current PRM-data/IEMSI "voice #"
  8344.  
  8345.  
  8346. [PASSWORD]
  8347.  
  8348.    Replaced with the current PRM-data/IEMSI "password"
  8349.  
  8350.  
  8351. The following are data from PRM-data DIRECTORY section
  8352.  
  8353.  
  8354.  
  8355.  
  8356.  
  8357.  
  8358.  
  8359.  
  8360.  
  8361.  
  8362.  
  8363.  
  8364.  
  8365.  
  8366.  
  8367.  
  8368.  
  8369.  
  8370.  
  8371.  
  8372.  
  8373.  
  8374.  
  8375.  
  8376.  
  8377.  
  8378.  
  8379.  
  8380.        Page 138              AceComm (tm) v 1.85
  8381.  
  8382.  
  8383.  
  8384.  
  8385.  
  8386. --------------------
  8387. PRM-data Directories
  8388. --------------------
  8389.  
  8390. [DIR_START]
  8391.  
  8392.    Replaced with the current PRM-data/DIR "start up"
  8393.    This is the directory AceComm is started in.
  8394.  
  8395.  
  8396. [DIR_FON]
  8397.  
  8398.    Replaced with the current PRM-data/DIR ".FON"
  8399.  
  8400.  
  8401. [DIR_CAP]
  8402.  
  8403.    Replaced with the current PRM-data/DIR ".CAP"
  8404.  
  8405.  
  8406. [DIR_SCR]
  8407.  
  8408.    Replaced with the current PRM-data/DIR ".SCR"
  8409.  
  8410.  
  8411. [DIR_KTS]
  8412.  
  8413.    Replaced with the current PRM-data/DIR ".KTS"
  8414.  
  8415.  
  8416. [DIR_DNLDS]
  8417.  
  8418.    Replaced with the current PRM-data/DIR "dnlds"
  8419.    <ChgDir> [DIR_DNLDS] <RunProgram>DSZ rz -mr <ChgDir> [DIR_START]
  8420.  
  8421.  
  8422. [DIR_NODELIST]
  8423.  
  8424.    Replaced with the current PRM-data/DIR "nodelist"
  8425.  
  8426.  
  8427. [DIR_MAILIN]
  8428.  
  8429.    Replaced with the current PRM-data/DIR "mail_in"
  8430.  
  8431.  
  8432. [DIR_MAILOUT]
  8433.  
  8434.  
  8435.  
  8436.  
  8437.  
  8438.  
  8439.  
  8440.        Page 139              AceComm (tm) v 1.85
  8441.  
  8442.  
  8443. Chapter 16  MACRO Parameter Symbols
  8444.  
  8445.            PRM-data Representatives (continued)
  8446.  
  8447.    Replaced with the current PRM-data/DIR "mail_out"
  8448.  
  8449.  
  8450.  
  8451. --------------
  8452. PRM-data Modem
  8453. --------------
  8454.  
  8455. [MDM_INIT]
  8456.  
  8457.    Replaced with the current PRM-data/MDM "init"
  8458.    <SendStr>[HANGUP]^M~[MDM_INIT]^M
  8459.  
  8460.  
  8461. [DIAL_PREFIX]
  8462.  
  8463.    Replaced with the current PRM-data/MDM "dial prefix"
  8464.  
  8465.  
  8466. [DIAL_SUFFIX]
  8467.  
  8468.    Replaced with the current PRM-data/MDM "dial suffix"
  8469.  
  8470.  
  8471. [ANSWER]
  8472.  
  8473.    Replaced with the current PRM-data/MDM "answer"
  8474.  
  8475.  
  8476. [HANGUP]
  8477.  
  8478.    Replaced with the current PRM-data/MDM "hangup"
  8479.  
  8480.  
  8481. [OFFHOOK]
  8482.  
  8483.    Replaced with the current PRM-data/MDM "off hook"
  8484.  
  8485.  
  8486. [ABORT]
  8487.  
  8488.    Replaced with the current PRM-data/MDM "abort"
  8489.  
  8490.  
  8491. [RESET]
  8492.  
  8493.  
  8494.  
  8495.  
  8496.  
  8497.  
  8498.  
  8499.        Page 140              AceComm (tm) v 1.85
  8500.  
  8501.  
  8502. Chapter 16  MACRO Parameter Symbols
  8503.  
  8504.            PRM-data Representatives (continued)
  8505.  
  8506.    Replaced with the current PRM-data/MDM "reset"
  8507.  
  8508.  
  8509. [ECHO]
  8510.  
  8511.    Replaced with the current PRM-data/MDM "echo"
  8512.  
  8513.  
  8514. [HOST_INIT]
  8515.  
  8516.    Replaced with the current PRM-data/MDM "host init"
  8517.  
  8518.  
  8519. [CMD_LINE_TERMINATOR]
  8520.  
  8521.    Replaced   with   the   current   PRM-data/MDM  "command  line
  8522.    terminator"
  8523.  
  8524.  
  8525. ------------------------
  8526. Ansi Video Control Modes
  8527. ------------------------
  8528.  
  8529. [AttrOff]
  8530.  
  8531.    All attributes Off, reset to gray
  8532.  
  8533.  
  8534. [Bold]
  8535.  
  8536.    Bold color attribute
  8537.  
  8538.  
  8539. [Faint]
  8540.  
  8541.    Faint color attribute
  8542.  
  8543.  
  8544. [Italic]
  8545.  
  8546.    Italics text on
  8547.  
  8548.  
  8549. [Blink]
  8550.  
  8551.    Blinking attribute on
  8552.  
  8553.  
  8554.  
  8555.  
  8556.  
  8557.  
  8558.        Page 141              AceComm (tm) v 1.85
  8559.  
  8560.  
  8561. Chapter 16  MACRO Parameter Symbols
  8562.  
  8563.            PRM-data Representatives (continued)
  8564.  
  8565.  
  8566.  
  8567. [RBlink]
  8568.  
  8569.    Rapid blinking attribute on
  8570.  
  8571.  
  8572. [Rev]
  8573.  
  8574.    Reverse video attribute on
  8575.  
  8576.  
  8577. [Con]
  8578.  
  8579.    Concealed attribute
  8580.  
  8581. -------------------------
  8582. Ansi Video Control Colors
  8583. -------------------------
  8584.  
  8585. The following foreground colors become intense with [Bold], and normal with
  8586. [Faint].
  8587.  
  8588. Replaceable macro          Foreground Color
  8589. -----------------          ----------------
  8590.  
  8591. [Bla]                      Black
  8592. [Red]                      Red
  8593. [Gre]                      Green
  8594. [Yel]                      Yellow
  8595. [Blu]                      Blue
  8596. [Mag]                      Magenta
  8597. [Cya]                      Cyan
  8598. [Whi]                      White
  8599.  
  8600.  
  8601. Replaceable macro          Background Color
  8602. -----------------          ----------------
  8603.  
  8604. [BBla]                     Black
  8605. [BRed]                     Red
  8606. [BGre]                     Green
  8607. [BYel]                     Yellow
  8608. [BBlu]                     Blue
  8609. [BMag]                     Magenta
  8610. [BCya]                     Cyan
  8611.  
  8612.  
  8613.  
  8614.  
  8615.  
  8616.  
  8617.        Page 142              AceComm (tm) v 1.85
  8618.  
  8619.  
  8620. Chapter 16  MACRO Parameter Symbols
  8621.  
  8622.            PRM-data Representatives (continued)
  8623.  
  8624. [BWhi]                     White
  8625.  
  8626.  
  8627. -------------------------
  8628. Ansi Video Cursor Control
  8629. -------------------------
  8630.  
  8631.  
  8632. Replaceable macro          Background Color
  8633. -----------------          ----------------
  8634.  
  8635. [CUp]                      Cursor Up 1
  8636. [CDn]                      Cursor Down 1
  8637. [CFw]                      Cursor Right 1
  8638. [CBw]                      Cursor Left 1
  8639. [Cls]                      Clear Screen
  8640. [Cle]                      Clear to End Of Line
  8641.  
  8642. --------------
  8643. Host Mode Data
  8644. --------------
  8645.  
  8646. [USR_NAM]
  8647.  
  8648.    Caller name as found in the USERLIST.LST file.
  8649.  
  8650. [CURTIME]
  8651.  
  8652.    Replaced with the current time in 12 hour format.
  8653.  
  8654. [DCDTIME]
  8655.  
  8656.    Replaced with the online time.
  8657.  
  8658.  
  8659.  
  8660.  
  8661.  
  8662.  
  8663. o  Replaceable MACRO Functions are UPPER case only
  8664.  
  8665. %B
  8666.    Insert ascii baud, %B is replaced with current baud setting in ascii
  8667.    format.  Current baud setting is UART line speed, if the port is locked,
  8668.    this will differ from the modem connect speed.
  8669.  
  8670.  
  8671.  
  8672.  
  8673.  
  8674.  
  8675.  
  8676.        Page 143              AceComm (tm) v 1.85
  8677.  
  8678.  
  8679. Chapter 16  MACRO Parameter Symbols
  8680.  
  8681.            Replaceable Macro Functions
  8682.  
  8683. %C
  8684.    Insert ascii connect speed, same as above, but CONNECT speed in stead of
  8685.    port rate.
  8686.  
  8687. %P
  8688.    Insert ascii port, %P is replaced with current port number is ascii format.
  8689.    Port number is 1 based (com1 =1, com2 =2)
  8690.  
  8691. %FN   (Valid when used from <FileLister_>)
  8692.  
  8693.    Use from File Lister Area, %FN is replaced with currently "highlighted"
  8694.    filename.
  8695.  
  8696. %PF
  8697.    Prompt for filename, %PF is replaced with what you type into the prompt box.
  8698.  
  8699. %WK
  8700.  
  8701.    Wait for Key press, stops MACRO execution and waits for a key press.
  8702.  
  8703.  
  8704.  
  8705.  
  8706.  
  8707.  
  8708.  
  8709.  
  8710.  
  8711.  
  8712.  
  8713.  
  8714.  
  8715.  
  8716.  
  8717.  
  8718.  
  8719.  
  8720.  
  8721.  
  8722.  
  8723.  
  8724.  
  8725.  
  8726.  
  8727.  
  8728.  
  8729.  
  8730.  
  8731.  
  8732.  
  8733.  
  8734.  
  8735.        Page 144              AceComm (tm) v 1.85
  8736. Chapter 17  Scripts
  8737.  
  8738. Chapter 17  Scripts
  8739.  
  8740.  
  8741.  
  8742.  
  8743.  
  8744. AceComm generates script files automatically when running in "AutoScriptGen"
  8745. mode.  The macro <AutoScrGen_> puts AceComm into "Script Learn".  AceComm's
  8746. default keyboard file, assigns ALT A to toggle <AutoScrGen_> on.
  8747.  
  8748.  
  8749. "AutoScriptGen" first prompts for a filename to use for the script file.  The
  8750. extension .SCR will automatically be appended.
  8751.  
  8752. ╔═Input Window══════════════════════════════════════════════════
  8753. ║═Enter filename, <ENTER> alone when done, ESC-abort════════════
  8754. ║>=> D:\ACE\CSERVE░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  8755. ╚═══════════════════════════════════════════════════════════════
  8756.  
  8757. Having a filename, AutoScriptGen creates the file and waits for activity.  We
  8758. want to call out.  Lets bring up the FON directory and select Compuserve.
  8759.  
  8760. ╔═ Telephone_directory fon\ACE.FON, 9 Records═══════════════════
  8761. ║═      System Name              Phone Number     Line Control V
  8762. ║ 1    AceComm Support BBS      1-602-846-2940     19200,8N1   A
  8763. ║>2    CIS (local phoenix 9600) 468-0285           19200,7E1   A
  8764. ║ 3    CIS (phones)             1-800-346-3247     2400,7E1    A
  8765. ║ 4    Comp USA #2              1-214-620-7993     19200,8N1   A
  8766. ║ 5    Supra Modem BBS          1-503-967-2444     19200,8N1   A
  8767. ║ 6  - Comput Connections (PCB) 1-202-547-2008     19200,8N1   A
  8768. ║ 7  - Comp USE (Dallas TX)     1-214-620-2255     19200,8N1   A
  8769. ║  Dial  Edit  <SPACEBAR>-Que  Circling_dial_queue  Fon_files  S
  8770. ╚═ Add_record  Remove_record  UnMark_All  Import  Paint  Quit  H
  8771.  
  8772. AutoScripGen will write Fon.Record information to the script file in the form
  8773. of macro commands.
  8774.  
  8775. The macro to start "Script Learn" is <AutoScrGen>.  AceComm's default setup
  8776. uses ALT A to toggle <AutoScrGen> on.  The following short scrip is exactly as
  8777. was recorded by the "Script Learn" function.
  8778.  
  8779. <INITFONREC>CIS (local phoenix 9600)
  8780. <FON_NUM>468-0285
  8781. <FON_LINECTRL>7E1
  8782. <FON_BAUD>19200
  8783. <FON_TERM>Av/An
  8784. <FON_FLAGS>Macro,DTag,Cap,Text,IEMSI,
  8785. <ReDials>100
  8786. <FON_REDIAL>
  8787. <LocalKeys>On
  8788.  
  8789.  
  8790.  
  8791.  
  8792.  
  8793.  
  8794.        Page 145              AceComm (tm) v 1.85
  8795.  
  8796.  
  8797. Chapter 17  Scripts
  8798.  
  8799.            AutoScriptGen (Tm)
  8800.  
  8801. <OPENCAPTURE>cserve.CAP
  8802. <SendStr>^M
  8803. <WaitStr>Host Name:
  8804. <SendStr>cis^M
  8805. <WaitStr>User ID:
  8806. <SendStr>75120,3306^M
  8807. <WaitStr>Password:
  8808. <SendStr>your/pwd^M
  8809. <WaitStr>r HELp!
  8810. <SendStr>rea^M
  8811. <WaitStr>e(s) # (or ALL)?!
  8812. <SendStr>all^M
  8813. <WaitStr>CR> for more !
  8814. <SendStr>^M
  8815. <WaitStr>CR> for more !
  8816. <SendStr>^M
  8817. <WaitStr>CR> for more !
  8818. <SendStr>^M
  8819. <WaitStr>e, REPly or NEXt!
  8820. <SendStr>^M
  8821. <WaitStr>CR> for more !
  8822. <SendStr>^M
  8823. <WaitStr>CR> for more !
  8824. <SendStr>^M
  8825. <WaitStr>e, REPly or NEXt!
  8826. <SendStr>^M
  8827. <WaitStr> ADDress or HELp!
  8828. <SendStr>^M
  8829. <WaitStr>ssages? (Y or N)!
  8830. <SendStr>n^M
  8831. <WaitStr>Enter choice !
  8832. <SendStr>go IbmPro^M
  8833. <CLOSECAPTURE>
  8834. <OPENCAPTURE>ibmpro.CAP
  8835. <WaitStr>CR> !
  8836. <SendStr>Read New^M
  8837. <WaitStr>CR> !
  8838. <SendStr>^M
  8839. <CLOSECAPTURE>
  8840. <WaitStr>Enter choice !
  8841. <SendStr>off^M
  8842. <WaitStr>Host Name:
  8843. <SendStr>off^M
  8844. <ENDS>
  8845.  
  8846.  
  8847.  
  8848.  
  8849.  
  8850.  
  8851.  
  8852.  
  8853.        Page 146              AceComm (tm) v 1.85
  8854.  
  8855.  
  8856. Chapter 17  Scripts
  8857.  
  8858.            AutoScriptGen (Tm) (continued)
  8859.  
  8860.  
  8861. To begin "Script Learn", I pressed ALT A for <AutoScrGen>.  This macro will
  8862. turn on "Script Learn" and prompt you for a filename.  Type in the filename for
  8863. the new script.  Next, I pressed ALT D for <PhoneList>, and selected the local
  8864. 9600 CIS record for dialing.
  8865.  
  8866. This segment was written to the script when entering the dialer.
  8867.  
  8868. <INITFONREC>CIS (local phoenix 9600)
  8869. <FON_NUM>468-0285
  8870. <FON_LINECTRL>7E1
  8871. <FON_BAUD>19200
  8872. <FON_TERM>Av/An
  8873. <FON_FLAGS>Macro,DTag,Cap,Text,IEMSI,
  8874. <ReDials>100
  8875. <FON_REDIAL>
  8876. <LocalKeys>On
  8877. <OPENCAPTURE>cserve.CAP
  8878.  
  8879. The dialer sees we are in "Script Learn" and writes the macros required to
  8880. initialize a Fon.Record.  Notice the "Flags" include opening a capture file
  8881. upon Dial/Connect.  The "Cap," flag was recorded here, and is responsible for
  8882. the "<OpenCapture>cserve.CAP" to be recorded into the script.  Because the
  8883. <OpenCapture> macro has been recorded, we want to edit out the "Cap," flag.  If
  8884. we leave it in, the capture file will be opened twice, it not be a problem,
  8885. except for duplicate time stamps.  It is nice to have a capture file open while
  8886. recording in "Script Learn", a capture file provides a good reference later on
  8887. when editing the script.
  8888.  
  8889. What follows is a script that captures a forum (IBMPRO) to a capture file, and
  8890. also checks for "Compuserve Mail" along the way.  I have CIS configured to
  8891. announce my mail, and so some decision making is required for the scripts to
  8892. operate all the time.  The fastest way for me to read a forum is to capture it
  8893. to file 2 or 3 times a week.  I can reply off line.  Since personal mail
  8894. announcements are capable of tripping up a script, like the one generated
  8895. above, some more complex macros are put to work.
  8896.  
  8897.  
  8898. ;    We can place comments into our scripts.  ";" is used as a comment
  8899. ;    character.  Text following ";" is a comment.
  8900.    <DispStr>[AttrOff] <ClrWin>
  8901.    <DispStr>[BWhi][Blu] <DispText>Intro <DispStr>[AttrOff]
  8902.    <DispStr>^M^JQ)uit
  8903.    <DispStr>^M^JAny key continues, or wait 10 seconds^M
  8904.    <GetKey>10    <if>Q <Goto>@@EndScript
  8905.  
  8906.  
  8907.  
  8908.  
  8909.  
  8910.  
  8911.  
  8912.        Page 147              AceComm (tm) v 1.85
  8913.  
  8914.  
  8915. Chapter 17  Scripts
  8916.  
  8917.            AutoScriptGen (Tm) (continued)
  8918.  
  8919.  
  8920. <INITFONREC>CIS (local phoenix 9600)
  8921. <FON_NUM>468-0285
  8922. <FON_LINECTRL>7E1
  8923. <FON_BAUD>19200
  8924. <FON_TERM>Av/An
  8925. <FON_FLAGS>Macro,DTag,Text,IEMSI,   ; I deleted "Cap," from the flags
  8926.  
  8927. <ReDials>100                        ; This macro gives control over how many
  8928.                                     ; times to re-dial before giving up.
  8929. <FON_REDIAL>
  8930. <LocalKeys>On
  8931. <OPENCAPTURE>cserve.CAP
  8932.  
  8933.  
  8934.  
  8935. ; Note: when stacking macros, a space character MUST precede the macro.
  8936. <SendStr>^M
  8937. <WaitTime>15                        ; 15 seconds to timeout (<WaitStr> only)
  8938. <WaitStr>Host Name: <SendStr>cis^M
  8939. <WaitStr>User ID: <SendStr>75120,3306^M
  8940. <WaitStr>Password: <SendStr>your/pwd^M
  8941.  
  8942. ;   The following checks for personal messages, "Compuserve Mail".
  8943. ;   waiting for me. I won't have messages waiting every time I log on to
  8944. ;   Compuserve. We need a way for the script to make decisions. If there are
  8945. ;   messages, we can stop and read them, recording them into the already open
  8946. ;   capture file, if no messages, we want to continue to capture the forum, and
  8947. ;   log off.
  8948.  
  8949.    <Timer0>30                       ; Set a timer to 30 seconds
  8950. :@@CheckMail                        ; Label we loop to while checking
  8951.    <CheckMdm>CompuServe Mail <if>1 <goto>@@PersonalMail
  8952.    <CheckMdm>messages pending <if>1 <goto>@@PersonalMail
  8953.    <CheckMdm>SCAn, REAd, <if>1 <goto>@@PersonalMail
  8954.    <CheckMdm>Enter choice ! <if>1 <goto>@@CompuserveTop
  8955.  
  8956.    <Timer0> <if>1 <Goto>@@CheckMail ; <if>1 while not timed out
  8957. ;
  8958. ;  Fall through to the forum on timeout
  8959. ;
  8960.    <SendStr>^M
  8961.    <Goto>@@IBMPRO
  8962. ;
  8963. ;  Here if we got a hit with <CheckMdm>. <CheckMdm> is not case sensitive.
  8964. ;
  8965.  
  8966.  
  8967.  
  8968.  
  8969.  
  8970.  
  8971.        Page 148              AceComm (tm) v 1.85
  8972.  
  8973.  
  8974. Chapter 17  Scripts
  8975.  
  8976.            AutoScriptGen (Tm) (continued)
  8977.  
  8978. :@@PersonalMail
  8979.    <WaitTime>10                     ; New, faster timeout for <WaitStr>
  8980.    <OPENCAPTURE>cismail.CAP         ; <WaitStr> falls through on timeout
  8981.    <SendStr>Read^M
  8982.    <WaitStr># (or ALL)?! <SendStr>all^M
  8983.  
  8984.    <Timer0>300          ; 5 minutes till timeout, up this if you are popular
  8985. :@@ReadMail
  8986.    <CheckMdm>CR> for more ! <if>1 <SendStr>^M
  8987.    <CheckMdm>REPly or NEXt! <if>1 <SendStr>Next^M
  8988.    <CheckMdm>SCAn, REAd, <if>1 <SendStr>^M
  8989.    <CheckMdm>CR> for more ! <if>1 <SendStr>^M
  8990.    <CheckMdm>Delete these messages? (Y or N)! <if>1 <goto>@@AfterMail
  8991.    <Timer0> <if>1 <goto>@@ReadMail
  8992. ;
  8993. ;  Fall through to here on timeout
  8994. ;
  8995. :@@AfterMail
  8996.    <SendStr>N^M
  8997.    <Timer0>60                       ; Here we use 2 timers in 2 loops
  8998. :@@CompuserveTop
  8999. :@@ResetTimer1
  9000.    <Timer1>10
  9001. :@@TenSecondLoop
  9002.    <CheckMdm>Enter choice ! <if>1 <goto>@@IBMPRO
  9003.    <CheckMdm>Last page ! <if>1 <SendStr>^M
  9004.    <Timer1> <if>1 <goto>@@TenSecondLoop
  9005.    <SendStr>^M
  9006.    <Timer0> <if>1 <goto>@@ResetTimer1
  9007.  
  9008. :@@LogOff
  9009.    <SendStr>off^M <Delay>5 <SendStr>off^M <Delay>2 <MdmHangup>
  9010.  
  9011. :@@IBMPRO
  9012.    <CLOSECAPTURE>
  9013.    <SendStr>go IbmPro^M <OPENCAPTURE>ibmpro.CAP
  9014.    <Delay>7
  9015.    <SendStr>Read New^M
  9016.    <MdmStill>10
  9017.  
  9018.    <CheckMdm>CR> ! <if>1 <SendStr>^M
  9019.    <CLOSECAPTURE>
  9020.                            ; If you want more forums
  9021.                            ; you can un-comment the following line
  9022.                           <Goto>@@IBMCOM
  9023.  
  9024.  
  9025.  
  9026.  
  9027.  
  9028.  
  9029.  
  9030.        Page 149              AceComm (tm) v 1.85
  9031.  
  9032.  
  9033. Chapter 17  Scripts
  9034.  
  9035.            AutoScriptGen (Tm) (continued)
  9036.  
  9037.    <WaitTime>15
  9038.    <WaitStr>Enter choice ! <SendStr>off^M
  9039.    <WaitStr>Host Name: <SendStr>off^M
  9040.    <MdmHangup>
  9041.    <Goto>@@EndScript
  9042.  
  9043. :@@IBMCOM
  9044.    <SendStr>go IBMCOM^M <OPENCAPTURE>ibmCOM.CAP
  9045.    <Delay>7
  9046.    <SendStr>Read New^M
  9047.    <MdmStill>10
  9048.  
  9049.    <CheckMdm>CR> ! <if>1 <SendStr>^M
  9050.  
  9051.    <CLOSECAPTURE>
  9052.    <WaitTime>15
  9053.  
  9054.    <WaitStr>Enter choice ! <SendStr>off^M
  9055.    <WaitStr>Host Name: <SendStr>off^M
  9056.    <MdmHangup>
  9057.  
  9058. :@@EndScript
  9059.  
  9060. <ENDS>
  9061.  
  9062. {-DATA_AREA-}
  9063. {-TEXT_START-}Intro
  9064. ┌────── Compuserve Forums ───────────────────────────────────────────────────┐
  9065. │                                                                            │
  9066. │  This script calls Compuserve, and captures forums to their respectively   │
  9067. │  named capture files. The script demonstrates some basic decision making   │
  9068. │  using <CheckMdm> and <Timer0> macros. The script is capable of capturing  │
  9069. │  personal mail, if any, and continue on to get the forums.                 │
  9070. │  The script will pause for 10 seconds after it has logged onto Compuserve. │
  9071. │  This pause is where we detect for any "Compuserve Mail" that may be       │
  9072. │  waiting for us.                                                           │
  9073. │                                                                            │
  9074. │   You will need to edit the script where the login process sends your      │
  9075. │   CIS ID  and  CIS password.                                               │
  9076. └────────────────────────────────────────────────────────────────────────────┘
  9077. {-TEXT_END-}
  9078.  
  9079.  
  9080.  
  9081.  
  9082.  
  9083.  
  9084.  
  9085.  
  9086.  
  9087.  
  9088.  
  9089.        Page 150              AceComm (tm) v 1.85
  9090.  
  9091.  
  9092. Chapter 17  Scripts
  9093.  
  9094.            Labels, Gotos, Data Area
  9095.  
  9096.  
  9097.          :Label
  9098.             Labels begin with ':' character
  9099.             Labels are used as arguments to the <goto> macro
  9100.  
  9101.          <goto> label
  9102.             "Label"  can be defined any where in the script file, either
  9103.             before or after a <goto> macro.
  9104.  
  9105.          <if> condition
  9106.             AceComm supports a set of conditional macros. Conditional
  9107.             macros return either 1 or 0.
  9108.  
  9109.          {-DATA_AREA-}
  9110.             Defines a data area
  9111.  
  9112.          {-TEXT_START-}
  9113.           see examples
  9114.          {-TEXT_END-}
  9115.  
  9116.  
  9117.             {-Data_ Area-} will be covered extensively next month with
  9118.             many complex scripts as well as complete documentation.
  9119.  
  9120.             The following script introduces some un-documented script
  9121.             language features.
  9122.  
  9123.  
  9124.             Follows is a basic script which includes a data area.
  9125.  
  9126.          ------------snip here -------------
  9127.          <ClearWindow>
  9128.          <DispText>Intro
  9129.          <DispText>Ask_Continue
  9130.          :GetKey
  9131.          <GetKey>
  9132.             <if>Y
  9133.             <goto>Dial
  9134.             <if>N
  9135.             <goto>End
  9136.             <goto>GetKey
  9137.          :Dial
  9138.          <INITFONREC>ACECOMM Support BBS      ; Initialize a FON RECORD
  9139.          <FON_NUM>1-602-846-2940            ;
  9140.          <FON_BAUD>19200                    ;
  9141.          <FON_TERM>Av/An                    ;
  9142.  
  9143.  
  9144.  
  9145.  
  9146.  
  9147.  
  9148.        Page 151              AceComm (tm) v 1.85
  9149.  
  9150.  
  9151. Chapter 17  Scripts
  9152.  
  9153.            Labels, Gotos, Data Area (continued)
  9154.  
  9155.          <FON_REDIAL>                       ; Go into re dial mode
  9156.          <DispText>Connect
  9157.          <WAITSTR> your name:
  9158.          <GetDCD>                           ; <WaitStr> may have timed
  9159.             <if>1                           ; out
  9160.             <goto>Connect
  9161.             <goto>Dial
  9162.          :Connect
  9163.          <SENDSTR>Michael Phelps^M
  9164.          <SENDSTR>Y^M
  9165.          <SENDSTR>password^M
  9166.          <WAITSTR>Select:
  9167.          <SENDSTR>ff
  9168.          :End
  9169.          <ENDS>
  9170.  
  9171.  
  9172.          {-DATA_AREA-}
  9173.          {-TEXT_START-}Intro
  9174.          -- Generic Log On Script --
  9175.          {-TEXT_END-}
  9176.          {-TEXT_START-}Ask_Continue
  9177.          Continue (Y/n) {-TEXT_END-}
  9178.  
  9179.          {-TEXT_START-}Connect
  9180.          -- Connect --
  9181.          {-TEXT_END-}
  9182.          ------------snip here -------------
  9183.  
  9184.  
  9185.  
  9186. ------------snip here -------------
  9187.     <Wait_To_HHMM>15:45                ; wait till 3:45 pm
  9188.     <INITFONREC>A.C.E. Software Support; call Init FON function
  9189.     <FON_NUM>1-602-846-2940            ; set phone number
  9190.     <FON_BAUD>2400
  9191.     <FON_TERM>Av/An                    ; video type for script
  9192.     <FON_REDIAL>                       ; call redial function
  9193.     <WAITSTR>it a few moments.
  9194.     <SENDSTR>^M
  9195.     <WAITSTR>s your name:
  9196.     <SENDSTR>Michael Phelps^M
  9197.     <WAITSTR>ael Phelps [Y,n]?
  9198.     <SENDSTR>^M
  9199.     <WAITSTR>Password:
  9200.     <SENDSTR>melissa_jean^M
  9201.  
  9202.  
  9203.  
  9204.  
  9205.  
  9206.  
  9207.        Page 152              AceComm (tm) v 1.85
  9208.  
  9209.  
  9210. Chapter 17  Scripts
  9211.  
  9212.            Labels, Gotos, Data Area (continued)
  9213.  
  9214.     <WAITSTR>Select:
  9215.     <SENDSTR>f^M
  9216.     <SENDSTR>d^Mz^Mace170.arj^M
  9217.     <RecvZmo>
  9218.     <WAITSTR>Select:
  9219.     <SENDSTR>gyn^M
  9220.     <ENDS>
  9221.     <ENDS>
  9222. ------------snip here -------------
  9223.  
  9224.  
  9225.  
  9226.  
  9227.  
  9228. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9229. ;;
  9230. ;;          --  Mini Host Mode Script for AceComm v1.85  --
  9231. ;;
  9232. ;;  Note:  Labels are CaSe sensitive
  9233. ;;         :@@Start    will not be found if accessed as <goto>@@start
  9234. ;;                                                          => S <=
  9235. ;;         Labels begin with ':' character, and start at the beginning
  9236. ;;         of a line
  9237. ;;         Each label must be a unique character string
  9238. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9239. ;
  9240. ;         Back up here after caller
  9241. ;
  9242. ;;;;;;;;;;
  9243. :@@Start
  9244. ;;;;;;;;;;
  9245.  
  9246. <HostEcho>OFF <SendStr>ATE0^M       ; We do not want the modem to echo
  9247.                                     ; as AceComm handles this when we turn
  9248.                                     ; <Host_Echo>ON
  9249. <AutoAnswer>On
  9250.  
  9251.    <LocalKeys>Off
  9252.    <SetDTR>Off <Delay>1 <SetDTR>On  ; This will hang up most modems
  9253.    <SetLCtrl>8n1                    ; new macro for 1.85
  9254.    <Delay>2                         ; This will help wait for modem response
  9255.                                     ; strings to clear
  9256.  
  9257.    <DispText>TellAutoAnswer         ; Display text defined in Data Area
  9258.                                     ; %P (port), %B (connect speed)
  9259.    <DispStr>Port %P Setup for %B^M^JWaiting for caller^M^J
  9260.  
  9261.  
  9262.  
  9263.  
  9264.  
  9265.  
  9266.        Page 153              AceComm (tm) v 1.85
  9267.  
  9268.  
  9269. Chapter 17  Scripts
  9270.  
  9271.            Mini Host Script Example
  9272.  
  9273. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9274. ;
  9275. ; Top of wait for caller loop
  9276. ;
  9277. ;;;;;;;;;;
  9278. :@@Wait
  9279. ;;;;;;;;;;
  9280.    <DispStr>^M[CURTIME]^M
  9281.  
  9282.    <GetDCD> <if>1 <goto>@@DCDLogIn  ; Here is where we detect a caller
  9283.    <GetKey>5 <if>L <goto>@@LogIn   ; Allow local keyboard login
  9284.             <if>C <DOSShell_>
  9285.             <if>ALT+J <DOSShell_>
  9286.             <if>R <RunProg>list.com
  9287.             <if>E <goto>@@END       ; Provide a clean exit
  9288.    <goto>@@Wait                     ; 'Wait' is a case sensitive label...
  9289. ;
  9290. ; Here if carrier detected
  9291. ;
  9292. :@@DCDLogIn
  9293. ;
  9294. ; Clear screen,  Send ansi video request,  Display banner
  9295. ;
  9296.    <Var0>0                          ; See if we can set this to 1 with
  9297.                                     ; our ansi video detection scheme.
  9298.    <Timer0>3                        ; Init Timer0 and set 3 second timeout
  9299.    <RawCapture>On                   ; Allow all caller's input in wait buffer
  9300.                                     ; ESC[6n  is video request (detect ansi)
  9301.    <SendStr>^L^[[6n^MMini Host Script for AceComm v1.85^M
  9302. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9303. ;
  9304. ; Loop here for 3 second maximum waiting for answer to Ansi detect sequence
  9305. ;
  9306. :@@DetectAnsi
  9307.    <CheckMdm> [ <if>1 <goto>@@AnsiDetected     ; Remote will answer with
  9308.    <Timer0> <if>1 <goto>@@DetectAnsi           ; ESC[n;nR  if ANSI capable
  9309.    <RawCapture>Off
  9310.    <HostEcho>ON                                ; HostEcho translates CR
  9311.                                                ; into CR,LF pair
  9312.    <DispStr>^M^JAnsi video request un-answered ; Ansi video request
  9313.    <goto>@@Welcome
  9314. :@@AnsiDetected
  9315.    <Var0>1
  9316.    <RawCapture>Off
  9317.    <HostEcho>ON                     ; HostEcho translated CR into CR,LF pair
  9318.    <SendStr> ^M^JAnsi video detected!
  9319.  
  9320.  
  9321.  
  9322.  
  9323.  
  9324.  
  9325.        Page 154              AceComm (tm) v 1.85
  9326.  
  9327.  
  9328. Chapter 17  Scripts
  9329.  
  9330.            Mini Host Script Example (continued)
  9331.  
  9332.  
  9333. :@@Welcome
  9334.    <Var0> <if>1 <DispStr>^M^J[Whi]Connected at [Blink][Bold][Red]%C[AttrOff]
  9335.    <Var0> <if>0 <DispStr>^M^JConnected at  %C
  9336.  
  9337. ;
  9338. ; Caller names are pre registered into an ascii comment file "USERLIST.LST"
  9339. ; Sample Line:  Michael Phelps,acecomm,9
  9340. ; where "acecomm" is the password
  9341. ;
  9342. ;;;;;;;;;;;
  9343. :@@LogIn
  9344. ;;;;;;;;;;;
  9345.    <Var0> <if>1 <DispStr>[Whi]
  9346.    <DispStr> ^M^JEnter your first and last name:
  9347.    <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd
  9348.    <DispStr>^M^J%FN not found!
  9349.  
  9350.    <DispStr> ^M^JEnter your first and last name:
  9351.    <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd
  9352.    <DispStr>^M^J%FN not found!
  9353.  
  9354.    <DispStr> ^M^JEnter your first and last name:
  9355.    <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd
  9356.  
  9357.    <DispStr>^L^M^JYour name has not been registered in the user file, you may
  9358.    <DispStr>^M^Joptionaly leave a short not for the SysOp, pleas include your
  9359.    <DispStr>^M^Jfirst and last name along with a password.
  9360.    <DispStr>^M^J^M^JWould you like to leave a note? (Y)es/(N)o
  9361. :@@1
  9362.    <GetKey>60
  9363.    <if>Y <goto>@@LogOffComment
  9364.    <if>N <goto>@@OFF
  9365.    <Goto>@@1
  9366. :@@GetPwd
  9367.    <DispStr> ^M^JEnter password:
  9368.    <GetStr>26 <UserPwd> <if>1 <goto>@@MainMenu
  9369.    <DispStr> ^M^JEnter password:
  9370.    <GetStr>26 <UserPwd> <if>1 <goto>@@MainMenu
  9371.    <DispStr> ^M^JEnter password:
  9372.    <GetStr>26 <UserPwd> <if>0 <goto>@@OFF
  9373.                               <goto>@@MainMenu
  9374. :@@LogOffComment
  9375.    <HostEcho>ON                     ; This needs be on for message, even local
  9376.    <GetMsg> <Goto>@@OFF
  9377. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9378.  
  9379.  
  9380.  
  9381.  
  9382.  
  9383.  
  9384.        Page 155              AceComm (tm) v 1.85
  9385.  
  9386.  
  9387. Chapter 17  Scripts
  9388.  
  9389.            Mini Host Script Example (continued)
  9390.  
  9391. ;
  9392. ; Top of main menu loop
  9393. ;
  9394. :@@MainMenu
  9395.    <DispStr>^L
  9396.    <Var0> <if>1 <DispStr>[Bblu][Whi][Bold][Cle]
  9397.    <DispStr>                 --  AceComm Mini Host Script for AceComm v1.85 --
  9398.    <Var0> <if>1 <DispStr>[AttrOff]
  9399.    <DispStr>^M^J^M^J
  9400.  
  9401.    <Var0> <if>1 <DispText>AnsiMainMenu
  9402.    <Var0> <if>0 <DispText>MainMenu
  9403.  
  9404. :@@MainMenuKey
  9405.    <GetKey>60                       ; <GetKey> times out every n seconds
  9406.    <if>1 <goto>@@BBS                ; so if the caller drops carrier, we
  9407.    <if>C <goto>@@Comment            ; can fall through to the carrier check
  9408.    <if>Y <goto>@@YourMail           ; below. Default timeout is 60 if param.
  9409.    <if>R <goto>@@ReadMail
  9410.    <if>F <goto>@@Files
  9411.    <if>G <goto>@@OFF
  9412.    <if>^M <goto>@@MainMenu          ; ^M for <CR>
  9413.  
  9414.    ; Note: any invalid key press while off line,
  9415.    ;       results in '<goto>'@@Start
  9416.    <GetDCD> <if>0 <goto>@@NoDCD     ; Detect if caller hung up
  9417.    <goto>@@MainMenuKey              ; Wait for a key press we can process
  9418.  
  9419. :@@BBS
  9420.    <ChgDir>BBS <RunProg>BBS %P %C <ChgDir>[DIR_START]
  9421.    <goto>@@MainMenu
  9422. :@@Comment
  9423.    <HostEcho>ON                     ; This needs be on for message, even local
  9424.    <GetMsg> <Goto>@@MainMenu
  9425. :@@YourMail
  9426.    <HostEcho>ON                     ; This needs be on for message, even local
  9427.    <YourMsg> <Goto>@@MainMenu
  9428. :@@ReadMail
  9429.    <HostEcho>ON                     ; This needs be on for message, even local
  9430.    <ReadMsg> <Goto>@@MainMenu
  9431. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9432. ; Files Menu
  9433. ;
  9434. :@@Files
  9435.    <DispStr>^M^L^M
  9436.    <Var0> <if>1 <DispStr>[BWhi][Blu]
  9437.  
  9438.  
  9439.  
  9440.  
  9441.  
  9442.  
  9443.        Page 156              AceComm (tm) v 1.85
  9444.  
  9445.  
  9446. Chapter 17  Scripts
  9447.  
  9448.            Mini Host Script Example (continued)
  9449.  
  9450.    <DispStr>^M^J  ┌────────────────────────────────┐
  9451.    <DispStr>^M^J  │ (Z)modem  AceComm version 1.85 │
  9452.    <DispStr>^M^J  │ (D)ownload file                │
  9453.    <DispStr>^M^J  │ (U)load file                   │
  9454.    <DispStr>^M^J  │ (L)ist file titles             │
  9455.    <DispStr>^M^J  │ (R)aw directory list           │
  9456.    <DispStr>^M^J  │ (M)ain menu                    │
  9457.    <DispStr>^M^J  │ (G)ood bye                     │
  9458.    <DispStr>^M^J  └────────────────────────────────┘
  9459.    <Var0> <if>1 <DispStr>[AttrOff]
  9460.    <DispStr>^M^J^M^JSelect:
  9461.  
  9462. :@@FilesKey
  9463.    <GetKey>60
  9464.    <if>Z <goto>@@DownloadAceComm
  9465.    <if>D <goto>@@DownloadFile
  9466.    <if>U <goto>@@UploadFile
  9467.    <if>L <goto>@@ListFiles
  9468.    <if>R <goto>@@RawDir
  9469.    <if>M <goto>@@MainMenu
  9470.    <if>G <goto>@@OFF
  9471.    <if>^M <goto>@@Files
  9472.    <GetDCD> <if>0 <goto>@@NoDCD     ; Detect if caller hung up
  9473.    <goto>@@FilesKey
  9474.  
  9475. :@@DownloadAceComm
  9476.    <SendZmo@>@ACECOMM.LST
  9477.    <goto>@@Files
  9478. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9479. ; Provide Download Options
  9480. ;
  9481. :@@DownloadFile
  9482.    <ChgDir>[DIR_DNLDS]              ; So files displayed with
  9483.                                     ; <DirList>[DIR_DNLDS]\*.* can be found
  9484.    <DispStr> ^M^JEnter filename: <GetStr>15 <DispStr>^M
  9485. :@@ChooseDnProtocol
  9486.    <DispStr>^M^JZ)modem
  9487.    <DispStr>^M^JY)modem  / Ymodem G
  9488.    <DispStr>^M^JX)modem
  9489.    <GetKey>60
  9490.    <if>Z <goto>@@ZmodemSend
  9491.    <if>Y <goto>@@YmodemSend
  9492.    <if>X <goto>@@XmodemSend
  9493.  
  9494.  
  9495.  
  9496.  
  9497.  
  9498.  
  9499.  
  9500.  
  9501.  
  9502.        Page 157              AceComm (tm) v 1.85
  9503.  
  9504.    <if>^M <goto>@@RetFiles
  9505.  
  9506.    <GetDCD> <if>0 <goto>@@NoDCD     ; Detect if caller hung up
  9507.    <goto>@@ChooseDnProtocol
  9508.  
  9509. :@@ZmodemSend
  9510.    <SendZmo>%FN
  9511.    <ChgDir>[DIR_START] <goto>@@Files
  9512. :@@YmodemSend
  9513.    <SendYmo1K>%FN
  9514. :@@RetFiles
  9515.    <ChgDir>[DIR_START] <goto>@@Files
  9516. :@@XmodemSend
  9517.    <SendXmo>%FN
  9518.    <ChgDir>[DIR_START] <goto>@@Files
  9519. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9520. ; Provide Upload Options
  9521. ;
  9522. :@@UploadFile
  9523. :@@ChooseUpProtocol
  9524.    <DispStr>^M^JZ)modem
  9525.    <DispStr>^M^JG)Ymodem G
  9526.    <DispStr>^M^JY)modem
  9527.    <DispStr>^M^JX)modem
  9528.    <GetKey>60
  9529.    <if>Z <goto>@@ZmodemRecv
  9530.    <if>G <goto>@@YmodemGRecv
  9531.    <if>Y <goto>@@YmodemRecv
  9532.    <if>X <goto>@@XmodemRecv
  9533.    <if>^M <goto>@@Files             ; <CR> alone aborts
  9534.  
  9535.    <GetDCD> <if>0 <goto>@@NoDCD     ; Detect if caller hung up
  9536.    <goto>@@ChooseUpProtocol
  9537.  
  9538. :@@ZmodemRecv
  9539.    <DispStr>^M^JBegin Zmodem Upload^M
  9540.    <RecvZmo>
  9541.    <goto>@@Files
  9542. :@@YmodemGRecv
  9543.    <DispStr>^M^JBegin Ymodem G Upload^M
  9544.    <RecvYmoG>                             ; Note: the sending Ymodem sends
  9545.    <goto>@@Files                          ; filename in the first data block
  9546. :@@YmodemRecv
  9547.    <DispStr>^M^JBegin Ymodem Upload^M
  9548.    <RecvYmo1k>
  9549.    <goto>@@Files
  9550. :@@XmodemRecv
  9551.    <DispStr> ^M^JEnter filename: <GetStr>15 <DispStr>^M
  9552.    <RecvXmo>%FN
  9553.    <goto>@@Files
  9554. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9555. ; Display ready made files list to caller
  9556.  
  9557.  
  9558.  
  9559.  
  9560.  
  9561.  
  9562.        Page 158              AceComm (tm) v 1.85
  9563.  
  9564.  
  9565. Chapter 17  Scripts
  9566.  
  9567.            Mini Host Script Example (continued)
  9568.  
  9569. ;
  9570. :@@ListFiles
  9571.    <SendAscii>files.lst
  9572.    <DispStr>^M^JPress CR
  9573.    <GetKey>60
  9574.    <goto>@@Files
  9575. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9576. ; Display directory to caller
  9577. ;
  9578. :@@RawDir
  9579.    <DispStr>^M^J
  9580.    <DirList>[DIR_DNLDS]\*.*
  9581.    <DispStr>^M^JPress CR
  9582.    <GetKey>60
  9583.    <goto>@@Files
  9584. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9585. ;
  9586. ; Here when caller selects G)o option
  9587. ;
  9588. :@@NoDCD
  9589.    <DispStr>^M^JCarrier not detected, Restarting script!
  9590.    <DispStr>^M^JLocal mode, you can navigate the script by making correct
  9591.    <DispStr>^M^Jkey press for the menu options.
  9592. :@@OFF
  9593.    <DispStr>^M^L^MGood bye [USR_NAM]!
  9594.    <DispStr>^M^JYour on line time [DCDTIME]^M^J
  9595.  
  9596.    <MdmHangUp>
  9597.    AutoAnswer>OFF                   ; Need this to recycle properly
  9598.  
  9599.    <Delay>2                         ; This will help wait for modem response
  9600.                                     ; strings to clear
  9601.    <goto>@@Start
  9602. ;
  9603. ; Here when local keyboard E)nd option is selected
  9604. ;
  9605. :@@END
  9606.    <AutoAnswer>OFF
  9607.    <ClrWin>
  9608. <EndS>
  9609. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  9610. {-DATA_AREA-}
  9611. {-TEXT_START-}TellAutoAnswer
  9612.  
  9613.               [37;44m --  AceComm Mini Host Script for AceComm v1.85 --  [0m
  9614.  
  9615.  
  9616.  
  9617.  
  9618.  
  9619.  
  9620.  
  9621.        Page 159              AceComm (tm) v 1.85
  9622.  
  9623.  
  9624. Chapter 17  Scripts
  9625.  
  9626.            Mini Host Script Example (continued)
  9627.  
  9628.    AceComm was first release on May 15 of 1993.  Since then the
  9629.    script/macro language has evolved slowly.  This is a very simple script
  9630.    allowing pre registered log in.  The macro language will continue to
  9631.    evolve making possible a more elaborate host script.  For a powerful
  9632.    Host mode, take a look at the AutoAnswer setup area.  People are using
  9633.    AceComm as a front-end, and calling their favorite BBS software from the
  9634.    AutoAnswer macros.  Sample setups for external BBS software are included
  9635.    in the manual.
  9636.                                             [34;47m┌──────────────────┐ [0m
  9637.                                             [34;47m│ L)ocal log in    │ [0m
  9638.                                             [34;47m│ C)ommand Shell   │ [0m
  9639.                                             [34;47m│ R)un LIST.COM    │ [0m
  9640.                                             [34;47m│ E)nd script      │ [0m
  9641.                                             [34;47m└──────────────────┘ [0m
  9642. {-TEXT_END-}
  9643.  
  9644. {-TEXT_START-}AnsiMainMenu
  9645.  
  9646.                     [34;47m┌─────────────────────┐ [0m
  9647.                     [34;47m│ 1) Through to BBS   │ [0m
  9648.                     [34;47m│ 2) Download (*.REP) │ [0m
  9649.                     [34;47m│ 3) Uplopad (*.QWK)  │ [0m
  9650.                     [34;47m│ C)omment to SysOp   │ [0m
  9651.                     [34;47m│ Y)our mail          │ [0m
  9652.                     [34;47m│ R)ead all messages  │ [0m
  9653.                     [34;47m│ F)iles              │ [0m
  9654.                     [34;47m│ G)o (hang up)       │ [0m
  9655.                     [34;47m└─────────────────────┘ [0m
  9656.  Enter Choice: {-TEXT_END-}
  9657. {-TEXT_START-}MainMenu
  9658.  
  9659.                    ┌─────────────────────┐
  9660.                    │ 1) Through to BBS   │
  9661.                    │ 2) Download (*.REP) │
  9662.                    │ 3) Uplopad (*.QWK)  │
  9663.                    │ C)omment to SysOp   │
  9664.                    │ Y)our mail          │
  9665.                    │ R)ead all messages  │
  9666.                    │ F)iles              │
  9667.                    │ G)o (hang up)       │
  9668.                    └─────────────────────┘
  9669.  Enter Choice: {-TEXT_END-}
  9670.  
  9671.  
  9672.  
  9673.  
  9674.  
  9675.  
  9676.  
  9677.  
  9678.  
  9679.  
  9680.        Page 160              AceComm (tm) v 1.85
  9681. Chapter 18  Whats New?
  9682.  
  9683. Chapter 18  Whats New?
  9684.  
  9685.  
  9686.  
  9687. =============================================================
  9688. 4/4/94 * Release version 1.85
  9689. =============================================================
  9690. Here is the largest upgrade since AceComm's debut on May 15 of 1993.
  9691.  
  9692. - Script processor has been re-worked, is capable of processing
  9693.   complex macro functions. A MINIHOST.SCR demonstrates much of the macro
  9694.   language. The macro language has now evolved to include intelligent
  9695.   decision making macros. See the CIS.SCR and MINIHOST.SCR for demos.
  9696. - Some macro text has changed. This requires a completlety new install from
  9697.   everyone.
  9698. - DPRM.EXE was fixed. It had a bug where the data pointer was not being saved
  9699.   correctly. DPRM is the utility that backs up the PRM file to an ascii
  9700.   definition file.
  9701.  
  9702. - Point mailer services have been either re-written or changed. The EMSI
  9703.   protocol has been re-written. Mailer services are capable of running in
  9704.   simple mailer front end mode.
  9705. -  The scheduler services allow a greater degree of control over a auto answer
  9706.    mode. The schedules now control the "Auto Answer Setup" services, which
  9707.    can only be accessed during a schedule which includes ",Host" attribute
  9708.    flag.
  9709. - New Point mail support menus have been added for automated event driven
  9710.   mailer/host modes. AceComm can serve as a complete front end to any BBS.
  9711. - FBL output ".NOD" files are no longer supported as Nodelist files. FBL will
  9712.   instead be re-written to support the creation of "mini" nodelist files.
  9713. - "Boss Data" areas allow user created system definitions to be retained
  9714.   permanently in the ACE.PRM file.
  9715.  
  9716.   The hooks for running a BBS software are numerous, and capable of passing
  9717.   port rate %B, connect speed %C, port %P.
  9718. - The Dialer sees some new "Phone Number Modifiers" menu.
  9719. - Fon files can be printed to ascii text or PRN from inside the "Import" menu.
  9720. - A new "CALL.LOG" does a 1 liner for each number called, with on line time
  9721.   down to the second.
  9722.  
  9723. - The configurations area "PRM-data" has bee re-organized. Always an effort
  9724.   is made to group similar data into more intuitive surroundings.
  9725. - Many little bug fixes, one larger one where the upload files selections could
  9726.   lock up if the user chose a particular sequence of events.  This due to a
  9727.   menu not getting closed properly.
  9728.  
  9729.  
  9730.  
  9731. =============================================================
  9732. 1/16/94 * Release version 1.81
  9733.  
  9734.  
  9735.  
  9736.  
  9737.  
  9738.  
  9739.        Page 161              AceComm (tm) v 1.85
  9740.  
  9741.  
  9742. Chapter 18  Whats New?
  9743.  
  9744. =============================================================
  9745. - Point mail functions using BOSS info were needlessly aborting
  9746.   when NODELIST or NLIST.IDX files were not available.
  9747. - Auto Log on was scanning the first 10 fields and ignoring the last
  9748.   six.
  9749. =============================================================
  9750. 12/26/93 * Release version 1.8
  9751. =============================================================
  9752.  
  9753. Update made for 1.8 include:
  9754.  
  9755.   AceComm is written in 100% assembly language.  This is how the EXE file
  9756.   remains so small.  The movement for menu data to a separate binary file is in
  9757.   the workings, this will allow for memory savings, multiple language support,
  9758.   and to a limited degree, user customizing.  AceComm for MS-Windows is coming
  9759.   along nicely, and like the DOS version, written in assembly language.  The
  9760.   GUI version featuring RIPscrip video will be available to registered users by
  9761.   March of 94.  Those wishing to see pre-release copies can get them.  Int 14h
  9762.   and FOSSIL support will be seen in a 1.86 release very soon.  I have them
  9763.   implemented, haven't enabled them yet.  I may tie an interrupt handler to
  9764.   buffer int 14h, as it's dog gone slow using BIOS the way they are.
  9765.  
  9766. - Fixed dialer timeout to recycle where values 60 seconds and greater would not
  9767.   timeout, but require a modem response in order to recycle.
  9768.  
  9769. - Zmodem receiver file management functions in a more expected manor.  User
  9770.   aborts would end with the file time not being updated to the file time sent
  9771.   by the remote.  This caused a later resume to be renamed instead.  ACE.DOC
  9772.   covers the logic behind file management used with Acecomm's internal zmodem.
  9773.  
  9774. - Script/macro processor gets attention every release, this area is very robust
  9775.   now.  The scrip language continues to inch along, what is here is very solid.
  9776.  
  9777. - AutoScrGen does a better overall job and can handle systems using HOT keys.
  9778.  
  9779. - Macro language evolves with each release.  The macro language and scripts
  9780.   capability will see the most attention from version to version.
  9781.  
  9782. - Terminal emulations saw some minor additions.  These always get added to and
  9783.   tweaked every version.
  9784.  
  9785. - Event schedules are more on line aware, and there is an enable flag where the
  9786.   schedules can be turned off completely.
  9787.  
  9788. - ACTL (assemble CTL) and DPRM (dis-assemble PRM) utilities are more data
  9789.   aware.  The PRM file can be almost 100% cloned across versions.
  9790.  
  9791. - LISTFILE prompting for batch uploads will now search the directory for all
  9792.  
  9793.  
  9794.  
  9795.  
  9796.  
  9797.  
  9798.        Page 162              AceComm (tm) v 1.85
  9799.  
  9800.  
  9801. Chapter 18  Whats New?
  9802.  
  9803.   LISTFILES and prompt the user "Send from this file Y/n)" before defaulting to
  9804.   the menu.  This allows multiple LISTFILES be ready to go, and used on the
  9805.   fly, greatly improving the fast up load selection process.
  9806.  
  9807. - Point mail services saw a lot of work and those using pre-release versions
  9808.   are getting good results with the scheduler and <PollBoss> macros.
  9809.  
  9810. - MDMI.EXE is included for the first time with this release.  MoDeM Install
  9811.   will read from an ascii format file of modem definitions.  The file can grow,
  9812.   MDMI.EXE will be able to use it as it grows.
  9813.  
  9814. - Mouse handler was re-written.  Mouse support is much more flexible.  Double
  9815.   click in terminal mode brings up the TopBar menu.
  9816.  
  9817. - KTS key definitions somehow got behind KBD definitions.  KTS are back to
  9818.   getting first crack at a key press.
  9819.  
  9820. - Xmodem was not opening file for 1.75, but dumping to the screen.  1.76 fixed
  9821.   this.  Both Xmodem and Ymodem (G) saw a lot of attention.  Mostly YmodemG.
  9822.   This protocol is not using file management that the Zmodem uses.
  9823.  
  9824. - Fixed a problem where writing the AceComm prompt to the DOS prompt when
  9825.   shelling to command processor, AceComm would overwrite any environment
  9826.   variables that were defined after the prompt.  This will be a noticeable fix
  9827.   for many.  This caused AceComm to lose it's ability to run programs if any
  9828.   PATH statement followed the prompt string.
  9829.  
  9830. - A trend for menus to become user definable is in the works.  It just seems to
  9831.   evolve this way since I wanted to move all the text out to an edit able area
  9832.   anyway.
  9833.  
  9834.  
  9835.  
  9836.  
  9837.  
  9838.  
  9839.  
  9840.  
  9841.  
  9842.  
  9843.  
  9844.  
  9845.  
  9846.  
  9847.  
  9848.  
  9849.  
  9850.  
  9851.  
  9852.  
  9853.  
  9854.  
  9855.  
  9856.  
  9857.        Page 163              AceComm (tm) v 1.85
  9858. Chapter 19  WARRANTY
  9859.  
  9860. Chapter 19  WARRANTY
  9861.  
  9862.  
  9863.  
  9864.  
  9865.  
  9866.  
  9867.  
  9868.  
  9869.  
  9870.  
  9871.  
  9872.  
  9873.  
  9874.  
  9875.  
  9876.  
  9877.  
  9878.  
  9879.  
  9880.  
  9881.  
  9882.  
  9883.  
  9884.  
  9885.  
  9886.  
  9887.  
  9888.  
  9889.  
  9890.  
  9891.  
  9892.  
  9893.  
  9894.  
  9895.  
  9896.  
  9897.  
  9898.  
  9899.  
  9900.  
  9901.  
  9902.  
  9903.  
  9904.  
  9905.  
  9906.  
  9907.  
  9908.  
  9909.  
  9910.  
  9911.  
  9912.  
  9913.  
  9914.  
  9915.  
  9916.        Page 164              AceComm (tm) v 1.85
  9917.  
  9918.  
  9919. Chapter 19  WARRANTY
  9920.  
  9921.  
  9922.  
  9923.  
  9924.  
  9925.  
  9926.                     DISCLAIMER - AGREEMENT
  9927.  
  9928.  
  9929.  
  9930.  
  9931. Users of AceComm must accept this disclaimer of warranty:
  9932.  
  9933. AceComm is supplied as is.  The author disclaims all warranties, expressed or
  9934. implied, including, without limitation, the warranties of merchantability and
  9935. of fitness for any purpose.  The author assumes no liability for damages,
  9936. direct or conse-quential, which may result from the use of AceComm.
  9937.  
  9938.  
  9939.  
  9940.  
  9941.  
  9942.  
  9943.  
  9944.  
  9945.  
  9946.  
  9947.  
  9948.  
  9949.  
  9950.  
  9951.  
  9952.  
  9953.  
  9954.  
  9955.  
  9956.  
  9957.  
  9958.  
  9959.  
  9960.  
  9961.  
  9962.  
  9963.  
  9964.  
  9965.  
  9966.  
  9967.  
  9968.  
  9969.  
  9970.  
  9971.  
  9972.  
  9973.  
  9974.  
  9975.        Page 165              AceComm (tm) v 1.85
  9976. Chapter 20  LICENSE
  9977.  
  9978. Chapter 20  LICENSE
  9979.  
  9980.  
  9981. AceComm is not a Public Domain program and is not free.  AceComm is copyright
  9982. (C) 1990-1993 by MGP Programming Services.
  9983.  
  9984. Non-registered users of this program are granted a limited 30 day license to
  9985. evaluate the programs suitability for their requirements.  Any usage of AceComm
  9986. beyond the evaluation time period requires registration of each copy of the
  9987. program used.  Use of non- registered copies of AceComm beyond the original
  9988. evaluation period is prohibited.
  9989.  
  9990. AceComm may NOT be modified in any respect, for any reason, including but not
  9991. limited to, de-compiling, disassembling, or reverse engineering of the
  9992. program.  The opening title screen, help screens, and all other proprietary
  9993. program output must never be altered, removed, bypassed or modified by any
  9994. means.
  9995.  
  9996. You are free to distribute the PUBLICLY AVAILABLE evaluation version of AceComm
  9997. to others subject to the above restrictions and also the following:
  9998.  
  9999.    A.   No fee is charged for its use.
  10000.  
  10001.    B.  No re numeration may be accepted for AceComm.  This does not apply to
  10002.         computer access charges the system operators (Sysops) of or
  10003.         organizations owning bulletin board systems, on line services, etc...
  10004.         may charge subscribers.
  10005.  
  10006.    C.  AceComm must be copied in unaltered form, complete with files containing
  10007.         license information, the FULL documentation and all accompanying
  10008.         files.  The self-extracting archive distributed by MGP Programming
  10009.         Services must not be altered in ANY respect.
  10010.  
  10011.    D.  All shareware houses/distribution firms must make explicitly clear that
  10012.         the diskette purchase containing any shareware program has NOT
  10013.         registered the software with the author MGP Programming Services
  10014.         Software/Michael G Phelps.
  10015.  
  10016.  
  10017.  
  10018.  
  10019.  
  10020.  
  10021.  
  10022.  
  10023.  
  10024.  
  10025.  
  10026.  
  10027.  
  10028.  
  10029.  
  10030.  
  10031.  
  10032.  
  10033.  
  10034.        Page 166              AceComm (tm) v 1.85
  10035.  
  10036.  
  10037. Chapter 20  LICENSE
  10038.  
  10039.  
  10040. System Operators may make AceComm available for download only if the above
  10041. conditions are met.  The archive (Acennnn.EXE) distributed by AceComm or an
  10042. equivalent archive may be made available only in complete form.  Refer to
  10043. FILELIST.DOC to verify complete package contents.  If the contents appear
  10044. altered or not complete, you may obtain the latest release of AceComm directly
  10045. from MGP Programming Services by sending a formatted diskette labeled with the
  10046. word "AceComm".  Please include $5 for handling.
  10047.  
  10048. The latest version of AceComm is also available on Compuserve.
  10049.  
  10050. Commercial distributors of "Public Domain", "Shareware", and/or User Supported
  10051. software may distribute AceComm subject to the above conditions only after
  10052. obtaining WRITTEN permission from MGP Programming Services.  This condition
  10053. statement supersedes all previous agreements.
  10054.  
  10055. Please refer to the section entitled registration/ordering section for
  10056. additional information on registration, corporate site-licensing and related
  10057. topics.
  10058.  
  10059.  
  10060.  
  10061.  
  10062.  
  10063.  
  10064.  
  10065.  
  10066.  
  10067.  
  10068.  
  10069.  
  10070.  
  10071.  
  10072.  
  10073.  
  10074.  
  10075.  
  10076.  
  10077.  
  10078.  
  10079.  
  10080.  
  10081.  
  10082.  
  10083.  
  10084.  
  10085.  
  10086.  
  10087.  
  10088.  
  10089.  
  10090.  
  10091.  
  10092.  
  10093.        Page 167              AceComm (tm) v 1.85
  10094.  
  10095.  
  10096. Chapter 20  LICENSE
  10097.  
  10098.  
  10099. The above license statement does not apply to the REGISTERED version of
  10100. AceComm.  The registered software of MGP Programming Services is protected
  10101. under United States Copyright and Trademark Laws.  It must be treated just like
  10102. a book with certain exceptions as follows:
  10103.  
  10104.    A.  MGP Programming Services authorizes the making of archival copies of the
  10105.        registered software for the sole purpose of backing-up your software and
  10106.        protecting your investment from possible loss.
  10107.  
  10108.    B.  The medium on which the registered software is recorded is transferred
  10109.        to the customer, but not the title to the software.
  10110.  
  10111.    C.  The customer may resell or distribute unmodified copies of the
  10112.        registered software provided the customer has purchased from MGP
  10113.        Programming Services one copy of the registered software for each one
  10114.        sold or distributed.  The provisions of this software license shall also
  10115.        be applicable to third parties receiving copies of the registered
  10116.        software from the customer.
  10117.  
  10118.    D.  By saying, "just like a book", MGP Programming Services means that the
  10119.        registered software may be used by any number of people and may be
  10120.        freely moved from one computer location to another so long as there is
  10121.        ABSOLUTELY NO POSSIBILITY of it being used at one location while being
  10122.        used at another.  Just like a book that cannot be read by two different
  10123.        people in two different locations at the same time.
  10124.  
  10125.  
  10126.  
  10127.  
  10128.  
  10129.  
  10130.  
  10131.  
  10132.  
  10133.  
  10134.  
  10135.  
  10136.  
  10137.  
  10138.  
  10139.  
  10140.  
  10141.  
  10142.  
  10143.  
  10144.  
  10145.  
  10146.  
  10147.  
  10148.  
  10149.  
  10150.  
  10151.  
  10152.        Page 168              AceComm (tm) v 1.85
  10153.  
  10154.  
  10155. Chapter 20  LICENSE
  10156.  
  10157.  
  10158.  
  10159. You can get more help by contacting the
  10160. author Michael Phelps at the following
  10161.  
  10162. AceComm Software Support
  10163. ------------------------
  10164. - VOICE 602-846-4563 6 days 12-7pm MST
  10165.  
  10166. - BBS   602-846-2940 24 hours
  10167.  
  10168. - COMPUSERVE User ID 75120,3306
  10169.  
  10170. - FIDONET ADDRESS 1:114/35
  10171.  
  10172. - FIDONET COMM echo
  10173.  
  10174. - FIDONET ACECOMM echo
  10175. I distribute the "ACECOMM" echo to
  10176. USA NODES, until it makes BACKBONE.
  10177.  
  10178. - Write to: MGP Software (AceComm)          * New address takes affect with
  10179.             BOX 301 C  Route 3                AceComm 1.85 release. Phone
  10180.             Detroit Lakes, MN 56501 USA       lines will remain the same until
  10181.                                               we actualy move later this year.
  10182.  
  10183.  
  10184.  
  10185.  
  10186.  
  10187.  
  10188.  
  10189.  
  10190.  
  10191.  
  10192.  
  10193.  
  10194.  
  10195.  
  10196.  
  10197.  
  10198.  
  10199.  
  10200.  
  10201.  
  10202.  
  10203.  
  10204.  
  10205.  
  10206.  
  10207.  
  10208.  
  10209.  
  10210.  
  10211.        Page 169              AceComm (tm) v 1.85
  10212. Chapter 21  AceComm Registration
  10213.  
  10214. Chapter 21  AceComm Registration
  10215.  
  10216.  
  10217.  
  10218. ┌─────────How to Register AceComm──────────────┬──────────────────────────────┐
  10219. │  Send $45.00 US to: MGP Software (AceComm)   │ Credit Card orders           │
  10220. │                     Box 301 C  Route 3       │ PSL part # 10805             │
  10221. │                     Detroit Lakes, MN 56501  │ 800-242-4775 or 713-524-6394 │
  10222. │─────────Life Time Registration───────────────┴──────────────────────────────┤
  10223. │                                                                             │
  10224. │  Registration gets you 1 FREE year of upgrades mailed to you at no charge.  │
  10225. │  Registration renewal each year for just 30%, renew at the end of a year,   │
  10226. │  or any time in the future. You will receive upgrades in the mail complete  │
  10227. │  with disks, manuals, news letters, BBS, voice and Compuserve support, and  │
  10228. │  continued expert software design.                                          │
  10229. │                                                                             │
  10230. │   AceComm (tm) for DOS and Windows, "Pace Setting Communications Software"  │
  10231. ├─────────Price Plans─────────────────────────────────────────────────────────┤
  10232. │                                       Each plan includes 1 year of FREE     │
  10233. │ (prices already include shipping)     upgrades mailed to you. Upgrades      │
  10234. │ 1) Registration           $45.00      include: 3.5 disk, manuals, news      │
  10235. │ 2) 10-30 copies            29.00      letters, unlimited software support.  │
  10236. │ 3) Site license           870.00                                            │
  10237. │ 4) Registration renewal    13.50  (for another year of disks,manuals,news)  │
  10238. │ 5) Competitive upgrade     26.00  (requires reg. disk from competitor)      │
  10239. │ 6) Senior discount 20%     36.00  (plan 1, 60 yrs, copy of drivers license) │
  10240. │                                                                             │
  10241. └───see the order forms and REGISTER.DOC for complete plan descriptions───────┘
  10242.  
  10243. AceComm Registration is required to use the software past it's 30 day trial
  10244. period.
  10245. Registration renewals buy you another year of free upgrades upgrades complete
  10246. with 3.5 disk, manuals, news letters for 1 year, BBS access.
  10247.  
  10248. Your registration will buy you the following:
  10249. ---------------------------------------------
  10250. - A license to use the AceComm software package.
  10251.  
  10252. - Free upgrades complete with 3.5 disk, manuals, news letters for 1 year.
  10253.  
  10254. - Eligibility for registration renewal at any time good for another year at
  10255.   just %30 current purchase price.
  10256.   Registration renewal need not to be right away, any time in the future.
  10257.  
  10258. - Access to the AceComm support BBS.  Here the latest code is always available
  10259.   to registered users, this in addition to the upgrades in the mail, sample
  10260.   scripts, tips from power users, ACECOMM message forum, the latest support
  10261.   files.  The AceComm BBS provides yet another form of software support.
  10262.  
  10263.  
  10264.  
  10265.  
  10266.  
  10267.  
  10268.  
  10269.  
  10270.        Page 170              AceComm (tm) v 1.85
  10271.  
  10272.  
  10273. Chapter 21  AceComm Registration
  10274.  
  10275. Register by Credit Card
  10276. -----------------------
  10277. As a service to AceComm customers who want to register by credit card,
  10278. arrangements have been made with the Public Software Library (PSL) to handle
  10279. all credit card registrations.  PSL accepts Visa, MasterCard, American Express,
  10280. and Discover Card.
  10281.  
  10282. Non-U.S.  residents are encouraged to register by credit card.  In many cases,
  10283. paying by credit card will be easier than acquiring U.S.  funds.
  10284.  
  10285. PSL will take the order information and forward it to the AceComm author, MGP
  10286. Programming Services & Michael G Phelps for processing and shipping.
  10287.  
  10288.  
  10289.  
  10290.  
  10291.  
  10292.  
  10293.  
  10294.  
  10295.  
  10296.  
  10297.  
  10298.  
  10299.  
  10300.  
  10301.  
  10302.  
  10303.  
  10304.  
  10305.  
  10306.  
  10307.  
  10308.  
  10309.  
  10310.  
  10311.  
  10312.  
  10313.  
  10314.  
  10315.  
  10316.  
  10317.  
  10318.  
  10319.  
  10320.  
  10321.  
  10322.  
  10323.  
  10324.  
  10325.  
  10326.  
  10327.  
  10328.  
  10329.        Page 171              AceComm (tm) v 1.85
  10330. Chapter 22  Order Form
  10331.  
  10332. Chapter 22  Order Form
  10333.  
  10334.  
  10335.  
  10336.  
  10337.  
  10338.                     AceComm & Utilities (Tm)
  10339.                          Version  1.85
  10340.                           ORDER FORM
  10341.  
  10342.  
  10343.  
  10344. FROM:
  10345.  
  10346.      Name: ____________________________________________________
  10347.  
  10348.   Address: ____________________________________________________
  10349.  
  10350.      City: ____________________________________________________
  10351.  
  10352.     State: ___________________________ Zip Code: ______________
  10353.  
  10354.   Country: ___________________________ Phone: _________________
  10355.  
  10356.  
  10357.  
  10358.  
  10359.  
  10360.                                    TO:
  10361.                                        MGP Software (AceComm)
  10362.                                        Box 301 C  Route 3
  10363.                                        Detroit Lakes, MN 56501
  10364.  
  10365.  
  10366.  
  10367.  
  10368.  
  10369.  
  10370.  
  10371.  
  10372.  
  10373.  
  10374.  
  10375.  
  10376.  
  10377.  
  10378.  
  10379.  
  10380.  
  10381.  
  10382.  
  10383.  
  10384.  
  10385.  
  10386.  
  10387.  
  10388.        Page 172              AceComm (tm) v 1.85
  10389.  
  10390.  
  10391. Chapter 22  Order Form
  10392.  
  10393.           AceComm & Utilities (Tm)  Version  1.85
  10394.  
  10395.                           ORDER FORM
  10396.  
  10397. Telephone   (602) 846-4563     MGP Software (AceComm)
  10398. AceComm BBS (602) 846-2940     Box 301 C  Route 3
  10399. CompuServe  75120,3306         Detroit Lakes, MN 56501
  10400. ===========================================================================
  10401.     Individual Registration Licensing use of AceComm and Utilities
  10402. ===========================================================================
  10403. Registration            Includes:    1 year of FREE Upgrades mailed to you.
  10404. Registration Renewal    Includes:    1 year of FREE Upgrades mailed to you.
  10405.  
  10406. 1 year of FREE Upgrades Include:     3.5 disk, Manuals, News letters,
  10407.                                      Good software support (see CONTACT.DOC)
  10408. -------------------(prices already include shipping)-----------------------
  10409.  
  10410. 1 Registration................$45.00   x number of copies Total $______ ___
  10411.  
  10412. Registration Renewal..........$13.50   x number of copies Total $______ ___
  10413.  
  10414. 10-30 Registrations           $29.00   x number of copies Total $______ ___
  10415.  
  10416. Site license                 $870.00   (call)             Total $______ ___
  10417.  
  10418. Senior discount 20%...........$36.00   x number of copies Total $______ ___
  10419. (60 yrs, copy of drivers license)
  10420.  
  10421. Competitive upgrade...........$26.00   x number of copies Total $______ ___
  10422. (requires reg. disk from competitor)
  10423. (must be a recent release, 18 months)
  10424. ================================================================
  10425.                                             TOTAL PRODUCTS      $______ ___
  10426.  
  10427.                      Sales tax for Arizona residents 6.75%      $______ ___
  10428.  
  10429.                                                TOTAL ORDER      $______ ___
  10430.  
  10431.              For payment by non-USA BANK CHECK, add $40.00      $______ ___
  10432.  
  10433.                   Overseas add $9.00/order  for shipping        $______ ___
  10434.  
  10435. Payment method:                             TOTAL ENCLOSED      $______ ___
  10436.            ( ) Check           ( ) Cash
  10437.            ( ) Money order
  10438.            ( ) Credit card (See instructions below)
  10439. Diskette format (choose one)  5.25" disk (__)  3.5" disk (__)
  10440.  
  10441.  
  10442.  
  10443.  
  10444.  
  10445.  
  10446.  
  10447.        Page 173              AceComm (tm) v 1.85
  10448.  
  10449.  
  10450. Chapter 22  Order Form
  10451.  
  10452.  
  10453.                     AceComm & Utilities (Tm)
  10454.                          Version  1.85
  10455.           AceComm Software Credit Card Registration Form
  10456.                     PSL Part number 10805
  10457.  
  10458.  
  10459.  
  10460.  
  10461.      The PSL part number for AceComm is: 10805
  10462.  
  10463.      Credit card registrations may be made by the following methods:
  10464.  
  10465.      -- Phone PSL at:
  10466.         800-242-4775  (Toll free) To register by credit card.
  10467.         713-524-6394  To  register  by  credit  card  and  for   order
  10468.                       inquiries.
  10469.  
  10470.      Be sure to have BOTH the credit card form at the end of this file
  10471.      PLUS the order form in the file ORDERFRM.DOC  available  to  give
  10472.      order information to PSL.
  10473.  
  10474.      ACCURACY in phone ordering is important!  Misspellings can result
  10475.      in delays or an erroneous registration.
  10476.  
  10477.      -- FAX PSL at 713-524-6398
  10478.  
  10479.      -- Email PSL at CompuServe user id 71355,470
  10480.  
  10481.      -- Write PSL at:
  10482.         The Public (Software) Library
  10483.         P.O. Box 35705
  10484.         Houston, TX 77235-5705
  10485.         USA
  10486.         PSL Part number 10805
  10487.  
  10488.      For FAX, email, or mail to PSL, send BOTH the credit card form at
  10489.      the   end   of  this  file  PLUS  the  order  form  in  the  file
  10490.      ORDERFRM.DOC.
  10491.  
  10492.      The Public Software Library also  maintains  a  vast  library  of
  10493.      shareware  and  public  domain  programs  and  prints  a  monthly
  10494.      magazine announcing new releases and general software news.
  10495.  
  10496.  
  10497.  
  10498.  
  10499.  
  10500.  
  10501.  
  10502.  
  10503.  
  10504.  
  10505.  
  10506.        Page 174              AceComm (tm) v 1.85
  10507.  
  10508.  
  10509. Chapter 22  Order Form
  10510.  
  10511.     AceComm & Utilities (Tm)  Version  1.85
  10512.  
  10513.      Please complete this form AND the regular order form in the file
  10514.      ORDERFRM.DOC and send BOTH DIRECTLY to:
  10515.  
  10516.  
  10517.                                         The Public (Software) Library
  10518.                                         P.O. Box 35705
  10519.                                         Houston, TX 77235-5705
  10520.                                         USA
  10521.        PSL Part number 10805            Date ________________________
  10522.  
  10523.          Name:  _____________________________________________________
  10524.  
  10525.       Address:  _____________________________________________________
  10526.  
  10527.                 _____________________________________________________
  10528.  
  10529.                 _____________________________________________________
  10530.  
  10531.      Card #:  ______________________________  Exp. Date:  ___________
  10532.  
  10533.      Signature of card holder: ______________________________________
  10534.  
  10535.  
  10536.  
  10537.  
  10538.  
  10539.  
  10540.  
  10541.  
  10542.  
  10543.  
  10544.  
  10545.  
  10546.  
  10547.  
  10548.  
  10549.  
  10550.  
  10551.  
  10552.  
  10553.  
  10554.  
  10555.  
  10556.  
  10557.  
  10558.  
  10559.  
  10560.  
  10561.  
  10562.  
  10563.  
  10564.  
  10565.        Page 175              AceComm (tm) v 1.85
  10566.  
  10567.  
  10568.  
  10569.   ( ) MasterCard  ( ) Visa  ( ) American Express  ( ) Discover Card
  10570.  
  10571.  
  10572.  
  10573.  
  10574.  
  10575.  
  10576.  
  10577.  
  10578.  
  10579.  
  10580.  
  10581.  
  10582.  
  10583.  
  10584.  
  10585.  
  10586.  
  10587.  
  10588.  
  10589.  
  10590.  
  10591.  
  10592.  
  10593.  
  10594.  
  10595.  
  10596.  
  10597.  
  10598.  
  10599.  
  10600.  
  10601.  
  10602.  
  10603.  
  10604.  
  10605.  
  10606.  
  10607.  
  10608.  
  10609.  
  10610.  
  10611.  
  10612.  
  10613.  
  10614.  
  10615.  
  10616.  
  10617.  
  10618.  
  10619.  
  10620.  
  10621.  
  10622.  
  10623.  
  10624.  
  10625.        Page 176              AceComm (tm) v 1.85
  10626.  
  10627.  
  10628. Chapter 22  Order Form
  10629.  
  10630.  
  10631.  
  10632. ┌───────────────────────────────────────────────────────────────────────────┐
  10633. │                 AceComm (tm)   version 1.85   4/3/94                      │
  10634. │                                                                           │
  10635. │                 Copyright 1991-1994 by MGP Software                       │
  10636. ├───────────────────────────────────────────────────────────────────────────┤
  10637. │                                                                           │
  10638. │ AceComm was first released in May of 1993.  The AceComm source code is    │
  10639. │ written in 100% assembly language, using TASM versions 2, and 3.1.  A     │
  10640. │ Windows version of AceComm is well under way, and should be released by   │
  10641. │ July of 94.  All of the generic code written for AceComm DOS version is   │
  10642. │ available to the Windows version.  This allows the two versions to evolve │
  10643. │ together, and operate much the same.                                      │
  10644. │                                                                           │
  10645. │ Latest code: Registered users can always upgrade any time using the       │
  10646. │              AceComm support BBS.                                         │
  10647. │                                                                           │
  10648. │ News letter: A news letter is sent to registed AceComm users. The news    │
  10649. │              letter contains example scripts, macro stacks, program       │
  10650. │              progress information. The news letter provides an efficient  │
  10651. │              means for users of AceComm software to be kept up to date.   │
  10652. │                                                                           │
  10653. │                                                                           │
  10654. └───────────────────────────────────────────────────────────────────────────┘
  10655.  
  10656.  
  10657.  
  10658.  
  10659.  
  10660.  
  10661.  
  10662.  
  10663.  
  10664.  
  10665.  
  10666.  
  10667.  
  10668.  
  10669.  
  10670.  
  10671.  
  10672.  
  10673.  
  10674.  
  10675.  
  10676.  
  10677.  
  10678.  
  10679.  
  10680.  
  10681.  
  10682.  
  10683.  
  10684.        Page 177              AceComm (tm) v 1.85
  10685.